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Stealth Linux 


y favorite scene from The 
Karate Kid (the original 
from 1984, sorry, I’m old) 


is when Mr Miyagi stops the Cobra 
Kai sensei, John Kreese, from beating 
up his defeated student. Miyagi is a 
small, feeble-looking old man, and 

he has no need to prove to anyone 
that he’s an awesome warrior. Linux 
is much the same: awesome and 
unassuming. Linux is slowly but surely 
taking over the world, embedded into 
cell phones, televisions, wristwatches 
and server rooms. Because Linux itself 
isn’t a commercial entity, it doesn’t 
need to be flashy, and it doesn’t need 
to brag. When it comes to embedded 
systems, Linux is “honking the nose” 
of proprietary alternatives, just like Mr 
Miyagi does to the bully. 

We start out our Embedded issue 
with Reuven M. Lerner’s column. This 
month, Reuven explores an alternative 
to the extremely popular Twitter 
Bootstrap. Zurb Foundation may 
sound like a character from Starcraft, 
but in fact, it’s a competitor to Twitter 
Bootstrap that is worth a look. Kyle 
Rankin takes the path less traveled as 
well this month with his solution to 
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SHAWN POWERS 


the Google Reader shutdown. One of 
the things | love about Linux is that 
there’s no single way to do anything. 
While | want a bookmark to take me 
from RSS site to RSS site, Kyle shows 
us to have articles delivered via e-mail. 
If that sounds interesting to you, 
check out his column this month for 
instructions on how he does it. 

Dave Taylor and | have a little 
crossover with our columns this 
month, which is completely 
coincidental, but very aptly timed. 
Dave explores the power of the 
ImageMagick suite of tools used 
in scripting. | follow later in the 
magazine with my column describing 
my homemade streaming Webcam 
of “BirdTopia”, or “Backyard” 
as others refer to it. | use some 
ImageMagick tools to manipulate the 
images pulled from my cell phones, 
all from scripts on my Linux server. 
I've enjoyed creating my BirdCam 
setup more than most of my Linux 
projects, and | hope it inspires you 
to try something similar! 

The truly embedded portion of this 
issue Starts with Bill Childers and 
his article on interfacing with your 


vehicle’s OBD system. Using Android 
and a fancy dongle, Bill explains how 
to get diagnostic information directly 
from your car! If your “Check Engine” 
light suddenly pops on, but gives no 
reason as to why, Bill’s article will be 
extremely helpful. Ronald Kurniawan 
goes one step deeper and shows how 
to use an $80 embedded system from 
Olimex to create a desktop system, or 
even a complete server. Proving there’s 
more to the tiny embedded world 
than just Raspberry Pi devices, Ronald 
walks through the entire process for 
getting a system running. 

Most new embedded systems take 
advantage of the U-Boot system 
for starting up. Bharath Bhushan 
Lohray covers U-Boot and some 
of its features, along with a few 
tricks. Whether you need to boot 
your embedded device from an SD 
card, a USB stick or even over TFTP, 
U-Boot can make modifications as 
simple as a device reboot. Bharath 
walks through the process and 
gives configuration examples. And 
finally, T.Rob talks about the future 
of the Cloud—specifically, the 
Personal Cloud. While the fluid size 
and burstable expansion of cloud 
computing has revolutionized the 
way we think about server rooms, it 
also has moved sensitive data out of 
our personal control. How do we deal 


with managing our personal, private 
data in a world focusing on selling 
services? T.Rob explores that and 
gives us a lot to consider. 

Much like “cloud” computing, 
“embedded” computing has a fairly 
flexible definition. One thing is 
certain, however, and that is that 
Linux is perfect for the embedded 
world, however you define it. With 
its breathtaking variety of hardware 
support and unassuming happiness 
living behind the scenes, the 
embedded market may be the vehicle 
Linux finally uses to take over the 
world. Year of the desktop? Pshaw, 
more like year of “the everything 
else”, with a little desktop on 
the side! Although Linux may not 
have the marketing campaign, or 
ad campaigns of the proprietary 
alternatives, much like Mr Miyagi, it 
doesn’t need it. Just do the job, do it 
well, and the rest will fall into place. 
We hope you enjoy this issue (very 
likely reading it on your embedded 
device); we certainly enjoyed putting 
it together! m 


Shawn Powers is the Associate Editor for Linux Journal. 
He’s also the Gadget Guy for LinuxJournal.com, and he has 
an interesting collection of vintage Garfield coffee mugs. 
Don't let his silly hairdo fool you, he’s a pretty ordinary guy 
and can be reached via e-mail at shawn @linuxjournal.com. 
Or, swing by the #linuxjournal IRC channel on Freenode.net. 
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Net Connectivity in Hotels 

In Doc Searls’ article “Dear Hotels: 
Quit Being A-holes” in the August 
2013 issue, he writes: “In the US 
and Europe, the expensive hotels 
are the ones with inconvenient 
connectivity deals....It’s the cheap 
hotels that offer free Internet, just 
like they offer free electricity, heat, 
air conditioning and running water.” 
I've recently stayed in youth hostels in 
northern Italy and in Alberta, Canada. 
They all had free Wi-Fi. Why would 
anyone stay in an expensive hotel? 


And, I'ma “youth” of 66—most youth 
hostels seem to have no age limit. 


—David Brown 
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Doc Searls replies: Coincidentally, | 
am a youth of 66 as well. So let’s toast 
staying young for the duration (clink!). 


As | said, mostly | stay in private homes 
(all with free Internet connections) when 
I’m paying my own way. And, | like 
AirBnB. But the youth hostel idea is also 
a good one, and even cheaper. Thanks! 


Cerberus, | 

In the August 2013 issue, Shawn 
Powers recommended the 
Cerberusapp application to track the 
location of your Android phone (see 
his UpFront piece titled “Android 
Candy: Hire a Cerberus to Find Your 
Phone”). This is indeed a great app; 
thanks for sharing. 


However, you should be 

aware of the privacy policy 
(https://www.cerberusapp.com/ 
privacy.php): “LSDroid uses your 
personally identifiable, location... 
information...to create new features, 
promotions, functionality and 
services....LSDroid uses cookies and 
log file information to...b) provide 
custom and personalized content, 
advertisements and information; 

c) monitor the effectiveness of our 
marketing campaigns....LSDroid 


discloses aggregate, anonymous log 
file and usage information in reports 
to interested third parties....” 


| just thought you and LJ readers 
should be aware of the privacy 
implications when using the app. 
—Aviv 


Ugh! Thanks for pointing that out. 
Creepy indeed.—Shawn Powers 


Archive CD? 

| already own the 1994-2009 Linux 
Journal Archive CD. Is there a way to 
just download/purchase the issues from 
2010 onward, or do | have to purchase 
another archive disk? Also, do you plan 
to have another Linux and Amateur 
Radio issue? | enjoyed the January 
2010 issue. P.S. | enjoy the articles in 
Linux Journal. keep up the good work. 
—Micheal Trombley 


The archive CDs are an all-or-nothing 
sort of thing. The intention isn’t to resell 
the same thing every year, but rather 

to provide a full archive for those folks 
hoping to catch up. They’re also nice 
for people like me who like to “collect 
the whole set”, but | don’t think there 
are any plans to release incremental 
updates. That said, subscribers have 
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access to the back issues—maybe that 
helps?—Shawn Powers 


Google Reader 

| saw Shawn Powers’ article on 
Google Reader via the Linux Journal 
RSS feed (“The Google Giveth” in 
the May 2013 issue). 


Go to http://keepamericaatwork.com. 
| decided to do this when Google 
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Reader disappeared, so that | wouldn't 
be dependent on any system. 


Basically, | host my own site, and | use 
a plugin called wp-o-matic that goes 
out and grabs the RSS feeds that | 
program it with. 


Because I’m using WordPress, | can 
categorize those feeds (look on the 
right-hand sidebar for the categories), 
and now | can view articles by category 
or by searching. Most important, | can 
click on a day in the calendar and read 
all feeds for that particular day. 


And, because | also have subscribed to 
Keep America At work via the e-mail 
subscription plugin, | automatically 
get a copy of everything that gets 
added via e-mail in case | become too 
busy to check the site itself. So far, it 
works like a champ. 


The downside is that if you're 
subscribed via the e-mail plugin, 
and you add a bunch of new feeds, 
you will get a bunch of e-mails 
until it processes the new feeds, 
but then because most places 
release only one or two articles 
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per day, it is very manageable. 
—Virgil 


Interesting concept. Over the past few months, I’ve 
written about a few ways to replace Google Reader, 
but creating a personalized blog that “writes itself” 
based on subscribed feeds...that’s interesting. Of 
course, it makes me want to have you add your 
own RSS feed to your feed aggregation setup, 

to see if it blows itself up, but that’s just the 
prankster in me coming out!—Shawn Powers 


Cerberus, Il 

| often pass on Shawn Powers’ “Android Candy” tips 
to my wife. | did so this month for the Cerberus app, 
but then almost immediately saw this story: “Google 
Unveils Android Version of ‘Find My iPhone’” 
(http://officialandroid.blogspot.com/2013/08/ 
find-your-lost-phone-with-android.html). 


You might want to alert your users to this 
development in next month's LJ. 
—Bob L. 


Thanks Bob! This is especially interesting based on 
Aviv’s letter regarding Cerberus. It does mean I'll be 
reading the fine print on the Google solution before 
installing though, that’s for sure.—Shawn Powers 
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WHAT’S NEW IN KERNEL DEVELOPMENT 


There recently was a flame war on 

the linux-kernel mailing list that 
got some attention outside the kernel 
community. It started when Greg 
Kroah-Hartman complained that 
people were sending patches for the 
Stable series that didn’t belong there, 
and Linus Torvalds suggested he 
learn how to yell at people more; then 
Sarah Sharp said that Linus shouldn't 
be advocating abuse. 

It turned out to be an interesting 
culture clash. Sarah posed her argument 
as, “Violence, whether it be physical 
intimidation, verbal threats or verbal 
abuse Is not acceptable. Keep it 
professional on the mailing lists.” And, 
“In karate, or any other sport, if your 
opponent is motionless on the floor, 
you stop. You can’t see the person 
you're emailing. You can’t see if the 
first conversation-disabling blow has 
completely knocked them out. You can’t 
see if you've misjudged their mental 
strength for the day and completely 
wiped out their ability to use their brain 
to correct the technical mistake you're 
trying to get them to fix.” 

Linus posed his response as being, 
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“People are different. I’m not polite, 
and | get upset easily but generally 
don’t hold a grudge—! have these 
explosive emails. And that works well 
for some people. And it probably 
doesn’t work well with you. And you 
know what? That's fine. Not everybody 
has to get along or work well with each 
other. But the fact that it doesn’t work 
with you doesn’t make it ‘wrong’.” And 
he said that the issue was really about 
“how to work together DESPITE people 
being different. Not about trying to 
make everybody please each other.” He 
gave the example of Sarah’s work with 
Greg, saying that they worked a lot 
with each other, probably because they 
did work well together, and that that 
was as it should be. 

The debate went on for a bit, and 
ultimately the two of them, and others, 
decided to continue the discussion at 
the upcoming Kernel Summit, over 
cookies and pot brownies. 

The debate interests me personally 
because, on the one hand, no one 
should ever be abused. That’s what 
abuse is—something that shouldn't 
happen. Otherwise, it’s just an activity. 


And on the other hand (in my opinion), 
not all of his “yelling” is really abuse. 
For one thing, it’s an e-mail list, and 
there is a long and glorious history of 
flame wars on e-mail lists. People aren't 
required to participate, even when 


(| UPFRONT | 


Linus Torvalds is the one doing the 
flaming. So I’m interested to see what 
kind of public pressure ultimately will 
come to bear on Linus to stop doing 
something that’s really an ordinary 
on-line activity.—ZACK BROWN 


Microsoft Office Word 2007 


word| 


(Image from http://www.launchy.net) 


With Unity’s method for launching and 
finding programs and applications, and 
OS X’s spotlight tool becoming the new 
way to launch programs, the entire way 
we think about launching programs is 
changing. Although | still like to have a 
few icon shortcuts on my task bar, many 
folks prefer a quick keystroke to bring up 
Gnome-Do, or Unity’s launcher, or even 
OS X's spotlight. If you’re one of those 
people, but can’t seem to find a smooth 
way to accomplish your launching on 
Windows, check out Launchy. 

Launchy is an open-source damon 


Non-Linux FOSS: Launchy! 


that runs on 
Windows, OS X or 
Linux. It listens for a 
predefined keystroke 
and then pops up 

a search window. 
You start typing 

the application, 
document or media 
file you want to 
start, and Launchy autocompletes based 
on its index of your system. The main 
advantage is the ability to launch a 
program without moving your fingers 
from the keyboard. 

Launchy is fast, accurate and doesn’t 
steal lots of resources on your system. 
| can’t find a way to make Windows 
behave this way on its own, so although 
Launchy is cross-platform, it probably 
will be the most useful for Windows 
users. You can download your copy 
today at http://www.launchy.net. 
—SHAWN POWERS 
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faint of heart, as 
it requires some 
PHP tweaking and 
really should be 
SSL-encrypted, 
but for anyone 
comfortable with 
configuring LAMP 
applications, 

it's Mot 
insurmountable. 


| love Dropbox. | really do. With 
a Google AdWords campaign, 
and $50 or so, | was able to 
max out my free storage. That 
means | have around 24GB of 
free Dropbox storage to fiddle 
with. Granted, that’s a lot, but 
in the grand scheme of things, 
24GB isn’t very much space. 
During the past few years, I’ve 
mentioned several alternatives 
(like SparkleShare), but the new 
kid on the block, OwnCloud, is 
a Web-based application that 
provides a plethora of cloud-based 
services. The most popular is its 
file syncing. 

Setting up OwnCloud isn’t for the 


16 / OCTOBER 2013 / WWW.LINUXJOURNAL.COM 


Once your server 
is installed, there are native syncing 
applications for Windows, OS X, 
Linux, Android and iOS. Because 
OwnCloud is hosted on your own 
server, your space limitation is based 
on your actual hard drive space! 

If you've ever wished your Dropbox 
data was hosted on your own 
servers, or if you just don’t have 
enough space, check out OwnCloud. 
It not only supplies file syncing, but 
with its extendible infrastructure, 
it also can do calendaring, sharing 
and pretty much anything else 
you'd want to do with cloud 
computing. Check it out today 
at http://www.owncloud.org. 
—SHAWN POWERS 
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Surf Safely with sshuttle 


In past issues, I’ve explained how to 
set up a SOCKS proxy with SSH. I’ve 
demonstrated how to tunnel traffic 
with SSH. I’ve even shown how to 
circumvent a company firewall with 
SSH. I’ve never been able to use SSH 
completely as a VPN, however, and 
that’s always bummed me out—until 
| discovered sshuttle. 

Mind you, sshuttle isn’t a new 
program. It isn’t even a new concept. 
What it is, however, is pure awesome. 
Basically, launching the sshuttle 
binary with root privileges will modify 


your system firewall 
to tunnel all (yes 
all) traffic through 
a remote SSH 
connection. The 
remote connection 
doesn’t even need 
administrator 
privileges, SO your 
shell account at 
your Web host 
might suffice for 
securing your 
traffic in a hotel 
or coffee shop. 
sshuttle will even 
tunnel your DNS 
lookups, which 
means your entire network interaction 
should be secure and encrypted. 
sshuttle is in many OS repositories, 
or you can downloaded it from 
https://github.com/apenwarr/sshuttle. 
With a simple sudo sshuttle 
--dns -vvr username@server 
0/0, all your traffic will be encrypted 
and funneled through the remote 
server. Because DNS also is tunneled, 
it means you won't be vulnerable 
to DNS poisoning either! Check out 
sshuttle today. You won't be sorry. 
—SHAWN POWERS 
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Mapping Your GIS Data 


I've already looked at some GIS 
applications available on Linux. 
Programs like GRASS and qgis 
provide a full set of tools to do 
GIS. Sometimes, that’s really 


overkill though. You may just want 
to display some data geographically 


and create a map. For those cases, 

there is Thuban, an interactive 

geographic data viewer 

(http://thuban.intevation.org). 
Most distributions should have 

a package available within their 


package management systems. If 
not, you always can download the 
sources and build it from scratch. 
It does depend on Python, among 
several other libraries, so you 
need to do a bit of a dependency 
dance. Binary downloads even are 
available for Windows and Mac 
OS X, so you Can point your 
non-Linux friends to them. 

If you don’t already have data 
of your own, sources of public- 
domain GIS data are available 


egend 0D © 


Thuban - unnamed map - | | xX 


Figure 1. Starting Thuban gives you a blank slate. 
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on-line. Here are a couple: 
http://www.naturalearthdata. 
com/features and http://wiki. 
openstreetmap.org/wiki/Shapefiles. 
The files available on these sites 
will get you started with SHP files 
that contain at least basic features 
for most of the world. 

Thuban is not as flexible as full- 
fledged GIS software and cannot 
handle very many data file formats. 
You can use SHP files, DBF database 
files and various image file formats. 
In the screenshots for this article, | 
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simply grabbed several of the data 
files available on-line. 

When you start Thuban, you end 
up with a completely blank slate 
(Figure 1). The first step is to start 
a new session, which you can do by 
selecting the menu item File>New 
Session (not much will change on the 
screen). In order to start building your 
map, you need to add layers that can 
be manipulated. | started by selecting 
the menu item Map—Add Layer and 
adding in an SHP file to give me the 
basic geographic attributes for my 


Select one or more data files 


¢ < [@jbernard > Downloads > new-brunswick 


Places -| Name 

@ Search = buildings.shp 
®Recently Used _|/s! landuse.shp 

Gig jbernard PB natural.shp 

Mi Desktop = places.shp 

File System ») points.shp 

10 GB Volume _ || ® railways.shp 

Documents ||»! roads.shp 

Si Music =) waterways.shp 

& Pictures 

Videos 

& Downloads 

a=] 


Modified | 
Yesterday at 02:52 
Yesterday at 02:52 


Yesterday at 02:52 | 


73.2 kB Yesterday at 02:52 
211.6 kB Yesterday at 02:52 
491.4 kB Yesterday at 02:52 
15.1 MB Yesterday at 02:52 
27.1MB Yesterday at 02:52 


Shapefiles (*.shp) v 
Open | Cancel 


Figure 2. Adding a new layer opens a file selection dialog where you can choose an SHP file. 
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Figure 3. By default, Thuban just displays all of the data with a single symbol color. 


home province of New Brunswick 
(Figure 2). This includes several 
different geographical items, such 
as water, river banks and parks. The 
default display is not very interesting 
yet (Figure 3). 

You can edit the way a layer is 
displayed either by double-clicking 
the layer within the list in the 
legend pane or by right-clicking 
the layer of interest and selecting 
Properties. This will pop up a new 
window (Figure 4). In this case, | 
selected the “type” field within 
the classification pane. The easiest 
choice at this point is to click 
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the Generate Class button. The 
Generate Classification window 
will pop up, where you can click 
on the Retrieve From Table button 
to get a list of the possible values. 
| accepted the default gray-scale 
mapping for the colors, giving four 
new entries in the layer properties. 
But this is not very interesting 
either, yet. Selecting each of the 
new properties, you can edit the 
symbol and change the colors for 
each of the types (Figure 5). If you 
want to have a preview of what 
this will look like, you can click 
the Try button. If it doesn’t quite 
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Layer Properties: natural 


Title: 


natural 
Layer Type: polygon 
Projection: None 
Classification 

Field: | type 

Data Type: Text 


Figure 4. Each layer 
has a properties 
window where you 
can control how the 
data gets displayed. 


| Visible Symbol Value | Label || Generate a 
Default — C] DEFAULT — 


Move Up 


Move Down 


Edit Symbol 


Remove 


<> 


Tr Revert | OK | Close 


look right, you always can click the 
Revert button to undo the changes 
and try something else. 

Although every map begins with 
a single layer, it is very rare that 
a single layer is enough to show 
all the details you may want to 
have displayed. In this example, | 
don’t have any roads on my map. 
A separate SHP file is available that 
has this information, however. So, | 
clicked on the menu item Map-—Add 
Layer and added the file roads.shp. 
Opening up the properties dialog 
shows that this particular SHP file 


has several different attributes to 
play with. For now, | selected four 
different road types and highlighted 
them with four different colors. 
There is still a default color for any 
road types other than the four | 
selected. To make them go away 

on the map, you can select the 
default property and simply make 

it transparent. Then, only the four 
selected road types will show up. 
Now the map is starting to look a 
bit more interesting, and | need to 
start worrying about what order the 
layers are in. 
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Figure 5. Using 

the Generate Class 
button is a shortcut 
to get you started. 


Title: natural 


Layer Type: polygon 
Projection: None 
Classification 

Field: | type 
Data Type: Text 


Layer Properties: natural 


< 


Thuban will draw layers in the 
order they appear in the legend list, 
Starting at the bottom and working 
its way up. You can move a particular 
layer up our down by selecting it and 
then using the buttons at the top of 
the legend pane. 

Another type of layer you can use 
is an image layer. Obviously, the 
image needs to be geo-referenced 
in some way. Thuban supports the 
geoTlFF file format. If you place 
your image at the bottom of the 
layer list, you then can draw on top 
of it with the data in the SHP files. 
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Visible © Symbol Value Label | | Generate Class | 
DEFAULT 
Default Add 
Singleton forest 
Singleton —_ park Move Lip__ 
Singleton [_riverbank | ne Move Down 
Singleton | 
Edit Symbol 


Remove 


<> 


Try Revert OK Close 


To manipulate the map itself, 
Thuban uses a sort of mode system. 
To zoom in, you need to select the 
zoom button. Then, you either can 
use click and drag to select a region 
to zoom in on or simply click a spot 
on the map to re-center and zoom 
in. Once you have zoomed in, you 
can use the pan tool to move the 
view window around the map to 
highlight different regions. There 
are buttons to zoom you to specific 
scales such that the entire map is 
visible. This always takes you back 
to the default map view. 


Two tools allow you to work with individual 
elements from an SHP file. The first is an 
information tool that pops up a detail 
window for any element you select. The 
second Is a label tool. When you select an 
element, a dialog window pops up allowing 
you to select one of the properties to be 
displayed as a label. 

Once you have a map you're happy with, 
you probably will want to save it for later 
use. Because Thuban works with sessions, all 
of your work in generating the map will be 
saved as a session within Thuban, as long as 
you remember to save it by clicking the menu 
item File—+Save Session. 

But, this doesn’t help much if you want 
to use your map outside Thuban. There is 
an option to export a map as an SVG file by 
using the menu item Extensions~Write SVG 
Map. This is not the most efficient output 
available, however. My simple example here 
blew up to more than 50MB for a single map 
with two layers. 

The other option is to print your map. 
Although you can print to actual paper, 
for a hard copy, you also can print to a file 
using the generic PostScript printer. This 
generates a PostScript file that will be a 
bit more manageable. You also can convert 
this PostScript file to other formats with 
relative ease. So, to get a PDF of your map, 
you can print to a PostScript file and then 
convert it to PDF with the ps2pdf utility. 
Now you have a map that you can share 
with friends and family.—joEY BERNARD 
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My home is not a 
place, it is people. 
—Lois McMaster 
Bujold 


The middle of 
the road is where 
the white line 
is—and that’s 

the worst place 
to drive. 
—Robert Frost 


The future will be 
better tomorrow. 
—Dan Quayle 


Some have been 
thought brave 
because they 
were afraid to 
run away. 
—Thomas Fuller 


Reading is 
no substitute 
for action. 
—Colleen 
Wainwright 
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When my 

family moved to Grand 
Rapids, Michigan, last 
year, one of the biggest 
adjustments was dealing 
with city parking. While 
we usually remember 
what side of the mall we 
parked on, there was a 
time downtown that | 
couldn't remember what 
parking garage we used, 
much less what level or 
spot. Thankfully, | had 
the parking ticket in my 
pocket, which included 
the address for the 
particular parking lot we 
used. Although we had 
to walk up 15 levels one 
by one to find the car, 
at least we knew it was 
there somewhere! 

If you've ever walked 
around a parking lot 
wondering if you were 
the victim of theft, or 
possibly going senile, 
Valet is the perfect app 
for you. It not only 


remembers the GPS location of 
your parked car, but it also has 

a timer to remind you of parking 
meter timing. Plus, if your car has 
Bluetooth connectivity, Valet will 
record where you left your car 
without any interaction on your 
part. It just marks the location 
where Bluetooth disconnected, and 
it happily guides you back when 
you've finished spending your 
paycheck at Teavana in the mall. 


(Maybe that’s just me.) 

In fact, Valet fills such a simple 
yet helpful purpose, it’s earned 
this month's Editors’ Choice award. 
Its automatic tracking based on 
vehicle Bluetooth is really the 
feature that puts it over the top for 
me. It’s the best $0.99 I’ve spent 
in a while. You can find it at the 
Google Play store, or check out the 
Web site: http://valetapp.co. 
—SHAWN POWERS 
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Foundation 


Designing a responsive Web site? Zurb Foundation is a worthy 


competitor to Twitter Bootstrap. 


I was recently speaking with a new 
client about a consulting project, and 
we were discussing the technologies 
we were going to use. | said, “So, | 
assume that we'll be using Twitter 
Bootstrap as a CSS framework, 
right?” Bootstrap, of course, is the 
open-source CSS framework written 
in the LESS language that recently 
released its third version, which has 
become wildly popular among Web 
developers. I’ve used Bootstrap on 
a number of projects in the past 
few years, and I’ve been pleasantly 
surprised to discover just how easily 
| could implement layouts, menus 
and sidebars, as well as produce 
nice-looking tables and buttons. 

| was surprised when the client 
said, “No, we're actually using Zurb 
Foundation.” Now, | had heard of 
Foundation before. Zurb is a Web 
design company based in California, 
whose Foundation framework 
preceded and inspired Bootstrap 
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in many ways. But it really hadn’t 
registered much on my radar, and 

| hadn't paid much attention to it. 
It turns out that | should have been 
paying attention. Zurb is a worthy 
competitor to Bootstrap, and it has 
some advantages that make it more 
appropriate in some cases. 

So in this article, | take a look at 
Zurb Foundation, considering it both 
as a Standalone CSS framework and as 
something you can use from within an 
application framework, such as Ruby 
on Rails. Zurb recently released version 
4 of the Foundation framework, 
and although it is not as popular as 
Bootstrap, the people who are using 
it seem to be quite passionate about 
its advantages. 


Foundation Basics 

If you aren't yet familiar with CSS 
frameworks, the idea is pretty 
straightforward. When you want to 
lay out a Web application, you likely 
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will want some headlines, some text, 
some sidebars, a menu and all sorts 
of other design elements. You could 
design the entirety of the layout, 
classes and CSS from scratch each 
time. Or, you could use predefined 
styles, designed to work with all sites, 
with a great deal of flexibility. 

Each modern CSS framework 
functions in this same way. You put 
text into divs and give each div a class 
indicating how many columns across 
it should be, up to the maximum 
number of columns defined by the 
framework. Foundation offers 12 
columns, meaning that you can lay 
out your design in one very wide 
column, two equally sized columns 
(6+6) or even something wilder, 
such as 3+4+5. 

Foundation, like other modern 
frameworks, goes way beyond 
just providing you with a nice 
grid. It also gives you control over 
navigation elements and forms, and 
even gives you some JavaScript- 
based elements for displaying 
images and dialog boxes. 

The bulk of Foundation is 
implemented using SCSS, a modern 
implementation of SASS. SCSS 
is a superset of CSS that can be 
compiled (using an open-source tool) 
into regular CSS files. However, you 
don’t need to know SCSS in order to 


use Foundation. 

How can you use Zurb Foundation? 
Download the package. You have 
several options, but the easiest one 
is to use the precompiled CSS files. 
Go to the Zurb Foundation download 
site at http://foundation.zurb.com/ 
download.php, and from there, 
click on the button for “download 
Foundation CSS”. 

If you want to change the defaults, 
you could download the SCSS version 
and do it that way. Alternatively, the 
good people at Zurb have provided 
a Web-based selection system, such 
that you can indicate what parts of 
Foundation you want, as well as which 
colors and styles. The CSS that you 
download then will be precompiled, 
customized according to your needs. 

If you download the simple CSS 
version and open the resulting zipfile, 
a sample HTML page (index.html) 
will be at the top level of the 
folders. There also will be several 
subfolders, whose names are fairly 
self-explanatory: js (JavaScript), css 
(stylesheets) and img (images). 

Looking at the HTML page, you 
can see that Foundation Is loaded in 
five steps: 

1) First, you load the core Foundation 
CSS file: 


<link rel="stylesheet" href="css/foundation.css"> 
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Now, this is definitely a long and 
complex CSS file. However, remember 
that this defines all of the styles, 
for all of the aspects of Foundation. 
Moreover, this is the result of 
translating the SCSS source into CSS; 
expressed as SCSS, the file is much 
shorter and easier to understand. 

2) After loading the Foundation 
CSS file, you then load Modernizr. 


Listing 1. Hello, world 


<!DOCTYPE htm1> 
<html> 


<head> 


<title>Minimal Zurb Foundation file</title> 


I've covered Modernizr in this column 
before; it allows you to test for certain 
HTML5 features and use alternatives 
if the feature doesn’t exist. You can 
use Modernizr in your application 
if you wish, but it's loaded here so 
that Foundation can handle different 
browser versions. 

3) Next, you load the JavaScript 
for Foundation. But here, things 


<link rel="stylesheet" href="css/foundation.css" /> 


<script src="js/vendor/custom.modernizr.js"></script> 


</head> 

<body> 
<hi>Hello, world headline</h1> 
<p>Hello, world paragraph</p> 
<script> 


document.write('<script src=' + 


('__proto__' in {} ? 'js/vendor/zepto' 


"S/VEMCKOle/ COMER”) se 1 Ses\/SCir ie?) 


</script> 


<script src="js/foundation.min.js"></script> 


<script> 
$ (document) . foundation() ; 
</script> 
</body> 
</htm1> 
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get a bit more interesting. Rather 
than a <script> tag that loads a 
JavaScript library, Foundation allows 
you to use either jQuery or Zepto, a 
lightweight library that copies many 
of jQuery’s most popular features. 
Foundation tests, at runtime, whether 
the __proto__ property is defined 

on an empty object ({}). If so, it loads 
Zepto. If not, it loads jQuery. This is 
where copying the code that comes 
with Foundation is probably the best 
choice; just make sure that when you 
deploy your application, you have 
both Zepto and jQuery available. 

4) Load the Foundation JavaScript 
file itself, which gives you the 
capabilities you wanted. 

5) Activate Foundation, using 
the formula by invoking the 
“foundation” function on the 
document object. This syntax works 
with both jQuery and Zepto: 


$(document) . foundation(); 


Note that although steps 1 and 2 
take place in the <head> section of 
the HTML file, the remaining steps 
(which involve JavaScript) are placed 
at the bottom of the page, just before 
the closing </body> tag. This is a 
common technique for speeding up 
JavaScript execution, and it ensures 
that the browser parses and displays 


the page before loading and executing 
external JavaScript files. 

A minimal file that uses Zurb 
Foundation (with a “Hello world” 
headline and paragraph in the body) 
is shown in Listing 1. 


Layouts with Foundation 
If you look at the file in Listing 1 
in your browser, you might well be 
disappointed by how it looks. The text 
is too close to the edge of the page, 
and it doesn’t have any of the pizazz 
that you would have expected from 
a framework. Well, there’s a simple 
reason for this. It hasn't used any of 
the styles that Foundation provides. 
So, let's begin by putting the text 
inside a <div> with a class of “row”. 
That shouldn’t come as a surprise to 
anyone who has used Bootstrap or 
other CSS frameworks; they often work 
this way, and also use a “row” class to 
indicate that you're now enclosing one 
horizontal band of text. The <body> 
(without the Foundation-specific 
JavaScript), thus, will look like this: 


<div class="row"> 
<h1l>Hello, world headline</h1> 
<p>Hello, world paragraph</p> 
</div> 


If you reload your browser, you'll see 
that the text has moved closer to the 
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center of the page. That's because using to display your site using appropriate 


the “row” class has defined margins, columns. Given these, the text looks 
as well as allowed your content to be like this: 
more centered and more responsive. 
While you're at it, make your window <div class="row"> 
smaller. At a certain point, the text <div class="Large-6 columns"> 
will make itself smaller, changing (on <h1>Hello, world headline</h1> 
my computer, at least) from 2.75em <p>Hello, world paragraph. And even more hello, world. And 
to 2.15em. The idea, of course, is that Sveiievel Wend Were felie, ward: Aid down, aise foree 
people with smaller browser windows And again. And even more hello, world. And even even more 
still should be able to see as much text hello, world. And so on, and so forth.</p> 
as possible, and that the text should </div> 
adjust itself proportionally. </div> 

Of course, your sites generally will 
include more text than just “Hello, If you want two side-by-side 
world.” I'll add some dummy text columns, you easily can do that: 
inside the paragraph, so that it takes 
up a few lines. But this time, | don’t <div class="row"> 
want the text to extend all the way to <div class="large-6 columns"> 
the right side. Rather, | want it to take <hl>Hello, world headline</h1> 
up only half the screen. <p>Hello, world paragraph. And even more hello, world. 

Foundation makes that easy to do. And even even more more hello, world. And so on, and 
Create a new <div> tag, and give it so forth. And again. And even more hello, world. And 
two classes. First, give it one that even even more more hello, world. And so on, 
represents the number of columns and so forth. </p> 
(out of 12) that you want your text to </div> 
use. So to extend all the way across, Sid -Giaess"targesd cowunne’s 
you would Say large-1 2. To extend <hl>Hello, world headline</h1> 
halfway across, you would say large-6, <p>Hello, world paragraph. And even more hello, world. 
and to extend one quarter of the And even even more more hello, world. And so on, and 
way across, you would use large-3. so forth. And again. And even more hello, world. And 
(If columns within a row don’t add even even more more hello, world. And so on, 
up to 12, you can get some funny- and so forth. </p> 
looking results.) Second, you add the </div> 


“columns” class, allowing Foundation = </aiv> 


30 / OCTOBER 2013 / WWW.LINUXJOURNAL.COM 


COLUMNS 


And, if you want both paragraphs 
of text under the same headline, you 
can do that as well: 


<div class="row"> 
<hl>Hello, world from a long headline</h1> 
<div class="Large-6 columns"> 
<p>Hello, world paragraph. And even more hello, world. 
And even even more more hello, world. And so on, and 
so forth. And again. And even more hello, world. And 


even even more more hello, world. And so on, and 


so forth.</p> 
</div> 
<div class="Large-6 columns"> 


<p>Hello, world paragraph. And even more hello, world. 


And even even more more hello, world. And so on, and 
so forth. And again. And even more hello, world. And 
even even more more hello, world. And so on, and 
so forth.</p> 

</div> 


</div> 


Now, could you have accomplished 
this on your own? Of course. But 
everyone who ever has worked with 
CSS knows it can be difficult to get 
this right. Moreover, what happens 
when someone wants to browse this 
site with a smartphone or a small 
browser window? Zurb Foundation Is 
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Raven X230/X230 Tablet 

¢ ThinkPad X230/X230 tablet by Lenovo 
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© 2.6-2.9 GHz Core i7 
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responsive, meaning that it adjusts 
automatically. This means that 
although you might have defined 
your paragraphs to be side by side, 
Foundation is smart enough to 
stack them vertically if the browser 
window is too narrow. You can see 
this for yourself by changing the 
width of your browser window with 
this page. 

It gets even better. Perhaps you 
want narrow browser windows, such 
as those used on cell phones, to 
continue displaying the columns side 
by side. This is where Foundation’s 
“dual grid” layout system shines. 
Just as you can use large-* classes 
for large browser windows, you 
can use small-* classes for small 
windows. Foundation automatically 
will apply the appropriate class, 
making it responsive in multiple 
ways. This means that each div will 
look like this: 


<div class="Large-6 small-3 columns"> 


Foundation also provides a number 
of button styles. You can use these 
in forms or by themselves for actions 
that you'll then hook up with 
JavaScript callbacks. A simple button 
can be given the “button” class: 


<input class="button" value="Press me" /> 
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You can use classes to change 
the button’s size (tiny, small, 
medium or large), color (secondary, 
alert or success) or even rounded 
corners (with a “round” class). 
The documentation indicated that 
“radius” should work as well as 
round, but it didn’t operate correctly 
within my Chrome browser window. 
You can combine these classes, such 
as in: 


<input class="button success large round" value="Press me" /> 


Buttons in Foundation handle 
hovering nicely as well, such that 
moving the mouse cursor over a 
button dims it, and clicking on it also 
gives visual feedback. Again, these are 
things you could do on your own, but 
why bother, when Foundation already 
has defined it? 


Navigation 

Most sites on which | work need 

to have a top navigation bar. 
Foundation handles this easily as 
well. For example, let’s say you want 
to have a title on the top navigation 
bar, and then links to pages 2, 3 and 
4 of your site. 

Doing this is a bit trickier than 
what you've seen so far, in that it 
requires some additional elements. 
Because I’m using HTML5 for this 
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example, let’s take advantage 

of two special elements defined 
there, <nav> and <section>, which 
Foundation expects. 

The top-level navigation bar Is 
defined in a <nav> element with a 
class of “nav-bar”. Within that, you 
start a <ul> element, normally used 
for bulleted lists, with a class of 
“title-area”. Now the magic begins. If 
you create an <li> element with classes 
of “name” and “active”, the navbar 
now will have a title. It’s typical to 
put that name in an h1 tag, and then 
to put the enclosed text inside a link, 
so that people can navigate to your 
organization’s home page: 


<nav class="top-bar"> 
<ul class="title-area"> 
<li class="name active"><hl><a href="#">Test site</a></h1></1i> 
</ul> 


</nav> 


You then can have one or more 
menu items, with the items flush left 
(with the title) or right (with the right 
side of the browser). Here, I've chosen 
to align it to the right. My menu items 
all go within a <section> tag, with the 
class of “top-bar-section”, and then 
an inner <ul>, with a class of “right” 
(indicating the alignment | want) and 
containing the menu items on the right 
side. The result looks like this: 


<nav class="top-bar"> 
<ul class="title-area"> 
<li class="name"><hl><a href="#">Test site</a></h1></1i> 
<section class="top-bar-section"> 
<ul class="right"> 
<li class="active"><a href="2.html">Page2</a></1Li> 
<li class="active"><a href="3.html">Page3</a></1i> 
<li class="active"><a href="4.htm1l">Page4</a></1i> 
</ul> 
</section> 
</ul> 


</nav> 


You can get even fancier if you 
want. Put the entire <nav> element 
inside a <div> whose class is “fixed”, 
and the navigation bar will stay at the 
top of the screen. 

Finally, your navigation bar may 
include drop-down menus. If, for 
example, you want the “page4” 
link to be a menu, add the 
“has-dropdown” class to the <li> 
tag. Then, within the <li>, add a new 
<ul> with a class of “dropdown”. 
The inner <li> elements then will be 
treated as menu items. For example: 


<li class="has-dropdown"><a href="4.htm1">Page4</a> 
<ul class="dropdown"> 
<li><a href="4.html">Page4a</a></1i> 
<li><a href="4.html">Page4b</a></1i> 
<li><a href="4.html">Page4c</a></1i> 
</ul> 


</1i> 
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Not only will the above function your site simultaneously for 
as a nice top-level menu, but the large and small screens. If you're 
Foundation CSS definitions also will designing an application that 
place a down-arrow hint next to the needs to work on mobile devices, 
“Page4” label, showing the user | definitely would consider 
that this is a menu, rather than an Zurb Foundation.= 


individual menu option. 


Web developer, trainer and consultant Reuven M. Lerner 


Conclusion is finishing his PhD in Learning Sciences at Northwestern 
It’s easy to see why Zurb University. He lives in Modi’in, Israel, with his wife and three 
Foundation has become popular. children. You can read more about him at http://lerner.co.il, 
It offers many of the positional or contact him at reuven@lerner.co.il. 


and navigational advantages of 
other CSS frameworks, allows 
easy customization with SCSS TUTTO LUPO 


(although | didn’t demonstrate Send comments or feedback via 

that in this column), and perhaps http://www.linuxjournal.com/contact 

best of all, it allows you to design or to ljeditor@linuxjournal.com. 
Resources 


The home page for Zurb Foundation is http://foundation.zurb.com. That site has good 
documentation and examples. 


A nice introduction to Foundation, albeit looking at the previous version from 2012, is at 
http://www.alistapart.com/articles/dive-into-responsive-prototyping-with-foundation. 


| also found it useful to read a comparison of Foundation with Bootstrap at 
http://abetteruserexperience.com/2013/08/twitter-bootstrap-3-vs-foundation-4- 
which-one-should-you-use. 


Finally, customization of Foundation is done with SCSS. You can read my previous 
articles on the subject, or go to the SASS Web site (which describes both the SASS 
and SCSS syntaxes) at http://sass-lang.com. 


34 / OCTOBER 2013 / WWW.LINUXJOURNAL.COM 


l gs 
AA 


OVH.COM 


Dedicated Server 


You are in Contro!! 


fedora” 


‘@ FreeBSD. 


HINUX. openSUSE. 


» 


‘a  &=— 
Damm 
TRS 


5 TB traffic 
24/7 North American Support 


CPU: 
Frequency: 
RAM: 
Hard disk: 


www.ovh.com/dedicated-servers 


For more details: 


<7 OVH.COM © 


Dedicated Servers Dedicated Cloud or contact us: 1-855-684-5463 


WORK THE SHELL 


COLUMNS 


Image 


DAVE TAYLOR 


Manipulation 


with ImageMagick 


Think shell scripts can deal only with text? You’ll be amazed at 
what you can do as Dave begins his exploration of ImageMagick 


and its many useful tricks. 


I've spent a lot of time in 
this column talking about text 
processing and analysis, with the 
basic assumption that if you're 
using the command line, you're 
focused on text. That's not always 
true, and if you work with images 
at all—whether JPEG, PNG, GIF or 
another format—there’s a free-to- 
download suite of image-related 
utilities available that offers rather 
amazing capabilities direct from the 
command line and, therefore, also 
from within shell scripts. 

I'm talking about ImageMagick, 
a set of programs that has grown 
and expanded through the years 
and now includes powerful Perl 
and Ruby interfaces too. But, 
oshaw! We don’t need no stinkin’ 
Perl or Ruby. We'll stick with our 
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hard-core shell commands, thank 
you very much. 

You'll find a downloadable 
binary and source both at 
http://www.imagemagick.org, 
and as always, | recommend you 
download source and compile it on 
your system if you can. It’s far more 
reliable than hoping someone else’s 
compiled version is optimized for 
your own hardware configuration. 

A variety of different commands 
are included with the ImageMagick 
distribution that | divide into 
“analysis” and “editing” tools. 
For this article, let’s stick with 
the analysis tools. Let me start 
by showing you how much more 
information it offers on a typical 
image file than the standard Linux 
command line. 
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Analyzing Images for Format: JPEG (Joint Photographic Experts Group JFIF format) 
Non-Optimized Resolutions Geometry: 970x311 
If you've been using Linux for even a Class: DirectClass 
short time, you've probably learned Colorspace: RGB 
about the file command. It can be Type: TrueColor 
helpful with some file types: Depth: 8 bits 
Endianess: Undefined 
$ file wp-content.tar.gz Channel depth: 
wp-content.tar.gz: gzip compressed data, from Unix Red: 8-bits 


Green: 8-bits 


But, the command is generally Blue: 8-bits 

useless with images: Channel statistics: 
Red: 
$ file pvp.jpg Min: 0 
pvp.jpg: JPEG image data, EXIF standard Max: 255 
Mean: 180.72 

Um, what about image size? How Standard deviation: 74.2122 
about any useful info at all? Jeez. Green: 

Enter the ImageMagick identify Min: 0 
command: Max: 255 


Mean: 168.593 


$ identify pvp.jpg Standard deviation: 76.0343 
pvp.jpg JPEG 970x311 DirectClass 114kb 0.010u 0:01 Blue 
Min: 0 

Ahh...so this particular image has Max: 255 
the dimensions (the suite refers to Mean: 169.459 
dimensions as the “geometry” of the Standard deviation: 77.244 
image) of 970x311. That's useful. Colors: 21864 

Do you want even more information Rendering-intent: Undefined 
though? The -verbose option spits Resolution: 72x72 
out a somewhat overwhelming Units: Undefined 
amount of data: Filesize: 114kb 


Interlace: None 
$ identify -verbose pvp.jpg Background Color: white 


Image: pvp.jpg Border Color: #DFDFDF 
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Matte Color: grey74 brethren—it’ll just load slower. 
Dispose: Undefined Here's one way you can identify images 
Iterations: 6 in a directory with incorrect resolutions: 


Compression: JPEG 


Orientation: Undefined #!/bin/sh 

JPEG-Quality: 94 identify=/usr/bin/identify 

JPEG-Colorspace: 2 # check images to ensure that they're all 72x72 resolution. 

JPEG-Sampling-factors: 1x1,1x1,1x1 for filename 

signature: bc8a6a698ca35fd8feab71452423386Ff98b1fb7b5ec ... do 

Profile-xmp: 811 bytes resolution=$($identify -verbose $filename | \ 

Profile-exif: 22 bytes grep -i "Resolution:" | grep -v 72x72) 

unknown if [ ! -z "$resolution" ] ; then 

Profile-app12: 15 bytes echo "Warning: Image $filename has $resolution" 

Tainted: False fi 

User Time: 0.020u done 

Elapsed Time: 0:01 exit 0 

Truth be told, dimensions and When | run this on a directory 
resolution are the most useful pieces of of images on my own system, a 
information from this crazy-long output. set of JPEG format files on my 

With a tiny bit of effort, you can http://www.AskDaveTaylor.com 


extract just those items of information: site, here’s what | get: 


$ identify -verbose pvp.jpg | grep -E '(Resolution: |Geometry:)' $ checkres.sh *.jpg 
Geometry: 970x311 Warning: Image auction-seller-imgl.jpg has Resolution: 75x75 
Resolution: 72x72 Warning: Image auction-seller-img2.jpg has Resolution: 75x75 


Warning: Image browsing-the-photo-folder.jpg has Resolution: 96x96 
Now imagine you are working ona Warning: Image brushed-metal.jpg has Resolution: 300x300 

Web site and want to ensure that no 

images on the site are greater than 


72dpi, a standard screen resolution. That's a surprise! | didn’t realize that 
Higher print-ready resolutions are | had 300x300 and these other weird 
rather pointless, because a 300dpi resolutions. An easy way to speed 
image will render the same on up my site, therefore, is to lower the 
a screen as its lower-resolution resolution on these images to the 
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standard 72dpi. This is something 
that also can be done with a call to 
a different ImageMagick utility, but 
let’s tackle that in another article. 


Working with Image Size 
Since | write a lot of scripts that 
harvest images or other content from 
sites and repurpose them for my own 
(generally private, not public-facing) 
use, | also find it is darn helpful in a 
shell script to be able to ascertain the 
size of an image I’ve just grabbed. 

If you've guessed that identify is 
the key, you're right. In fact, given an 
image, this is an easy way to grab Its 
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height and width: 
height=$(identify Simage | cut -d\ -f3 | cut -dx -f1) 
width=$(identify $image | cut -d\ -f3 | cut -dx -f2) 

There’s no need for verbose output, 
because the geometry of the image is 
included in the default output. 

Now it’s easy to produce higher- 
quality HTML, for example, by including 
images with their proper dimensions: 


echo "<img src=$image height=$height width=$width>" 


What's better is that Web browsers 
are able to scale images automatically, 


LINUX JOURNAL 


iPad 
IPhone 


Available on the 
i App Store 


linuxjournal.com/ios 


ANETWORK B wa 
WORK 


VER SERVER 
H THE 


KERNEL 
Ip a Music 

bm That 

lws You Around 


Get Started 
Programming 
the Arduino 


Create a Unified 
Boot Environment 
on a USB Drive 


For more information about advertising opportunities within Linux Journal iPhone, iPad and 
Android apps, contact John Grogan at +1-713-344-1956 x2 or ads@linuxjournal.com. 


WORK THE SHELL 


COLUMNS 


so if you specify a height and width 
that are different from the default 
dimensions (oops, sorry, “geometry”) 
of the image, it'll scale automatically. 
This means if | want to include the 
pvp.jog image on an automatically 
generated page, but decide 970 pixels is 
just too wide, | can simply include it as: 


<img src=pvp.jpg height=207 width=646> 


and the browser—be it Chrome, Safari 


or even MS IE—will scale it appropriately. 


Calculating the smaller size is 
straightforward with bc, another 
underappreciated Linux command. 
The entire sequence might look like 
this to scale the image to 66% of its 
original dimensions: 


#!/bin/sh 
identify=/usr/bin/identify 
scale=0.666 
jmage=$1 # add input validation code 
height=$($identify $image | cut -d\ -f3 | cut -dx -f1) 
width=$($identify $image | cut -d\ -f3 | cut -dx -f2) 
newwidth="$(echo $width \* $scale | bc | cut -d. -f1)" 
newheight="$(echo $height \* $scale | bc | cut -d. -f1)" 


echo "<img src=$image height=$newheight width=$newwidth>" 


exTt.0 
In practical use: 


$ scaledown.sh pvp. jpg 
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<img src=pvp.jpg height=646 width=207> 


That’s easy enough! 

With some creativity, you can see 
how even just the identify command 
that’s included with ImageMagick 
opens up a world of image file 
scripting possibilities, whether you're 
working with Web sites directly or 
simply seek to analyze directories of 
images for unusual values or settings. 

I'll dig into some of the really slick 
editing and modification capabilities, 
including an easy way to add a 
so-called watermark to your graphics, 
along with ways you can automate 
fixing 300dpi resolution images or even 
scaling images in an upcoming article. 

As a final note, although | explain 
how you can take a large image and 
have it show up smaller on a Web page 
by using different values for height 
and width, it would be remiss of me 
not to mention that if you're going to 
use only the smaller size, it’s smarter to 
resize the original image. It makes your 
page faster to load, less unneeded 
data is transferred and everything just 
generally is happier (including the 
search engines). Now you know. 


Dave Taylor has been hacking shell scripts for more than 
30 years. Really. He’s the author of the popular Wicked Cool 
Shell Scripts and can be found on Twitter as @DaveTaylor 
and more generally at http://www.DaveTaylorOnline.com. 
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Command-Line 


KYLE RANKIN 


Cloud: rss2email 


Now that Google Reader is dead and buried, I’ve switched to a 
much simpler approach to viewing RSS feeds. 


In my last article, | started a 
series called Command-Line Cloud. 
The intent of the series is to discuss 
how to use the cloud services we 

are faced with these days without 
resorting to a Web browser. | spend 
most of my time on the command 
line, so that’s where I'd most like to 
interface with cloud services. My last 
article described how to use Google 
Calendar from the command line, 
and in this article, | talk about a more 
general cloud service—RSS feeds. 

If | had written this column a few 
months ago, it would have been more 
focused on replacing Google Reader 
itself, because that was the primary 
RSS aggregator | used, but Google 
preemptively killed off the service and 
left a lot of users, including myself, 
scrambling to find a replacement. 
Although a number of people were 
able to find some sort of Web-based 
replacement, | realized the main 
features | wanted (sorting stories 


42 / OCTOBER 2013 / WWW.LINUXJOURNAL.COM 


by date and vi key bindings to view 
the next story) were absent in a 
lot of the existing Google Reader 
replacements. What’s worse, a lot 
of people were using this as an 
opportunity to make a quick buck 
by selling access to RSS services (and 
of course, still capturing everyone's 
valuable Web-viewing habits). 

| decided to take a completely 
different tack and convert my RSS 
feeds to e-mail in a special mailbox 
and use an interface | already was 
used to: e-mail on the command 
line using mutt. | decided to use the 
rss2email program, written by the 
great Aaron Swartz, to manage my 
feeds. This software pulls down RSS 
feeds and converts each story into its 
own e-mail message that it sends to 
you. This means you can use whatever 
e-mail program you want to read your 
feeds, but of course, because we are 
focusing on the command line here, | 
am going to talk about only mutt. 
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Installation and Configuration 
The rss2email program already had 
Debian packages, so on my system, 
installing it was as easy as typing 
apt-get install rss2email. lf 
for some reason it isn’t packaged for 
your distribution, follow the steps 
on http://www.allthingsrss.com/ 
rss2email/getting-started-with- 
rss2email to download and extract 
the rss2email tarball. This is Python 
software, so you will need Python 2.x 
on the system as well as some sort 
of local Sendmail program (Postfix or 
Exim works as well), or alternatively, 
you'll need to identify an outbound 
mail server you can use to send these 
e-mail messages. 

Once rss2email is installed, 
you interface with it via the r2e 
command. To set up a new rss2email 
database containing your feeds, type: 


$ r2e new youremail@yourdomain.net 


Note that the e-mail address 
you use here will be the e-mail to 
which rss2email will send the e-mail 
messages. Once the database is set 
up, it’s time to add feeds to it. You 
can do that with: 


$ r2e add http://feed.someurl.com/rss 


Or, if you happen to have an OPML 


file (such as you may have exported 
from Google Reader when you jumped 
ship), you can import that: 


$ r2e opmlimport file.opml 


At any point, you also can export 
all of your configured feeds from 
rss2email as an OPML file: 


$ r2e opmlexport 


Once you have added some feeds, 
you will want to poll them for new 
stories. Now the first time you run 
r2e against these feeds, it will pull in 
all stories in the feed, which probably 
includes some you already have seen. 
If you want to avoid that, the first 
time you will want to run: 


$ r2e run --no-send 
Otherwise, run: 
$ r2e run 


The first time it may take a while, 
because it reads all of your feeds 
and generates e-mail. Of course, by 
default, it will send all the stories 
to your INBOX, so because | control 
my own mail server, | created a 
special e-mail address for rss2email 
to use and then set up a procmail 
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rule so that it forwarded all e-mail 
messages sent to that address to a 
special rss mailbox. 

Of course, rss2email updates 
your feeds only when you run the 
command, so you probably will want 
to run this within cron so it updates 
automatically. Just run crontab -e 
as your regular user and add: 


a * * x r2e run 2>/dev/null 


This will run r2e every minute and 
output any random error (such as 
when feeds are temporarily down) 
to /dev/null instead of sending you 
e-mail every time. For the most part, 
rss2email works as is, but in my case, | 
wanted to change two extra settings. 
To do this, just open up ~/.rss2email/ 
config.py in a text editor and add the 
following settings: 


HTML_MAIL = 1 
DATE_HEADER = 1 


The first setting tells rss2email to 
send the e-mail as HTML mail, and 
the second dates the message based 
on the date of the news story, not 
the date it picked it up. Although 
you might be surprised that | opt for 
HTML e-mail in my text-based e-mail 
client, mutt automatically converts 
HTML e-mail to text for me. Plus, 
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when | tell mutt to open the e-mail 
in an external viewer, on pure shell 
sessions, it means | can view the full 
article in a text-based Web browser, 
such as w3m, very easily. And, when 
| run mutt on a machine with a Web 
browser, it can open the full article 
there instead. 


Managing Feeds 

Managing feeds in rss2email is 
relatively straightforward. First type 
r2e List to see a numbered list of 
all of your feeds. You will use the 
number associated with a feed to 
manage it. For instance, to get rid of a 
feed numbered 12, you would type: 


$ r2e delete 12 


You also can pause feeds if you want 
to ignore them temporarily with r2e 
pause number and then unpause it 
with r2e unpause number. 


Mutt as the Front End 

What makes this set up work so well 
for me is that | can use my regular 
mail program, mutt, to view my 
feeds. This means | quickly can scan 
my feeds and skip uninteresting 

or duplicate stories. In my case, | 
found | needed to tweak how mutt 
displays the index for this mailbox so 
| more easily could see who the feed 
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Terminal - greenfly@snowball: 


reports IT minister to the police, after she was spotted infringing copyright online on a 
1 calipers 


Figure 1. RSS Feeds inside Mutt 
was from. By default, mutt sets the 
index_format to: 

set index_format="%4C %Z %{%b %d} %-15.15L (%41) %s" 
So, | set up a folder-hook so that 


when I’m in the rss mailbox, | get a 
slightly tweaked index: 


folder-hook rss ‘set index_format="%4C %Z %{%b %d} %-20.20f %s"' 


The main change | made was to 
remove the column that displayed 
the size of the message (%4l), and 
had it display the complete FROM: 
line of the e-mail and gave myself 
a little extra room in that column 
(%-20.20f). The result is a much 
more readable feed list, as you can 
see in Figure 1. 

Although it’s true that | miss out 
on images within my news feeds, in 
many cases, that just means | miss 
out on ads or clipart. When | run 
mutt from a machine with a Web 
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browser and view the HTML, it opens 
the e-mail inside the Web browser, 
and from there, | can view images 

if | want. For those feeds that post 
only a summary of the article, | can 
follow the hyperlinks to the main 
article and read it in full. 

Viewing my news this way may not 
appear to be as full-featured as with 
using a Web-based client, but it’s a 
lot more flexible. Plus, in my case, 
| often have hundreds of stories to 
pore through, so viewing just the text 
versions of stories helps me focus on 
what's most important—the data.™ 


Kyle Rankin is a Sr. Systems Administrator in the San Francisco 
Bay Area and the author of a number of books, including The 

Official Ubuntu Server Book, Knoppix Hacks and Ubuntu Hacks. 
He is currently the president of the North Bay Linux Users’ Group. 
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Us a Bird. It’s = 
Another Bird! 


Build your own backyard Ustream—sorta. 


My new full-time job is one that office is that an office with a window 
| can do from my home office. One is almost guaranteed. Because | have 
of the perks of working at a home an office window for the first time in 


02:03:43 PM ips 


be 


Figure 1. BirdTopia as Seen via BirdCam 
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So, what does my obsession with bird watching 


have to do with Linux? 


my career (not counting the one year 
| had a part-time office facing the 
dumpster), | figured it would be the 
perfect opportunity to put up some 
bird feeders. 

Unfortunately for my family, but 
very fortunately for the local birds, 
when | decide to do something, 
| usually go all in. Rather than a 
simple feeder with mixed bird seed, 
| decided to get various types of 
feeders, specialized seed, a bird 
bath with flowing water and trees 
planted for shade and cover. My 
family refers to the area outside my 
office window as “BirdTopia” (Figure 
1). And they haven’t even seen the 
heated bird bath and peanut feeders 
| have planned for winter! 

So, what does my obsession with 
bird watching have to do with 
Linux? Well, obsession demands 
that either | stare out my window all 
day and lose my job, or | figure out 
some way to watch my birds while 
Staring at a computer screen. Enter: 
BirdCam. | needed a way to stream 
a live video feed of BirdTopia, 
without spending any more money. 
(The “not soend money” part was 
implied by my wife.) 


The Camera 

Because | don’t share an office with 
anyone, my camera options didn’t 
have to be pretty. | considered a 
USB Webcam, but all the Webcams 
| have are really low quality. 
Thankfully, | have a drawer full 

of old cell phones that have been 
replaced with newer models. | had 
three iPhone 3GS handsets and a 
Samsung Galaxy S2 with a cracked 
screen. The iPhones seemed to be 
in better shape, so first | tried to 
use one of them. | purchased a $5 
application called iWebcamera, 
which turns an iOS device into an IP 
camera with a built-in Web server. 
Unfortunately, the iPhone 3GS has 
a pretty cruddy camera, so although 
the application worked well, | 
wasn't satisfied. 

Next up was my Galaxy S2 phone 
with the cracked screen. Obviously 
the crack didn’t matter, and the 
camera Is much nicer. Also, the 
Google Play store has an app called 
IP Webcam that is completely free 
and completely awesome. The 
application puts a big-ugly ad on 
the screen of the phone, but the 
remotely viewed video has no ads 
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Figure 2. This suction cup is an improvement over my original “lean against the 


window’ design. 


at all. | highly recommend using an 
old Android device instead of using 
an old iOS device, if you happen 
to have the choice. | mounted the 
phone on the inside of my office 
window using a suction-mount 


cradle designed for a car (Figure 2). 


Viewing 
Both the iOS app and the Android 
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app have a built-in Web server 

that allows for direct viewing of 

the video stream (Figures 3 and 

4). The iOS application's interface 

is far less advanced than the free 
Android program, but they both 
allow for either viewing the mjpeg 
video stream or a real-time snapshot. 
With the Android application (which 
is what | focus on from here out, 
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ipCam - Links 


Note : Some links may not be supported by all browsers. 


Web Browser Links 


e JPEG Video 


P| = 
» MJPEG Video 


Raw Video Links 


= | om 


« JPEG Image 


» MJPEG Video 


Help 


e ipCam Support 


Figure 3. The iOS Web interface is functional, but sparse. 


because it’s free, Linux-based and me, however, it wasn’t enough. | 

far better), the resolution of the wanted to view my bird feeders from 

full-motion video is less than that multiple computers, both internal 

of the photo snapshot. and on the Internet. | also wanted 
The built-in Web server on the to be able to share my BirdCam 

phone is probably sufficient if you with the world, but | wanted to 

just want to watch from one or two serve everything myself, rather than 

computers on your network. For depend on a service like Ustream. 
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@ Android Webcam Server (op | 
@ | @ 192.168.1.201:80807/js.htm! + G| [Bec 
Android webcam server 


If no video appear below, check if soe have javascript enabled. 


Open camera controls v IP Webcam Remote - Mozilla Firefox - + x | 


Fullscreen view (click video to chang | ~& 492.168.1.201-8080/remote. htm! orc 


IP Webcam Remote 


Click here to play audio with browser _ 
Click here to play audio in external L Jurn.on LED | Turn off LED | 
; Autofocus 
Cancel autofocus 


Take full-res picture 


Autofocus and take full-res picture 


Audio, in case your external player does 
not support separate streams: 


"Click here to play audio with browser 

Click here to play audio in external media 
player. Right click here and select "save 
as" to record it. 


Figure 4. The Android Webcam software is far more robust. 


And, that’s where things started to in my home office has 5Mbit upload 
get really, really fun. speeds, it turns out that streaming 
multiple video feeds will saturate 
Video Is for Chumps that type of bandwidth very quickly. 
Well, it’s for chumps with insane | also had the problem of taxing 
bandwidth anyway. Although my the embedded Web server on the 
business Internet connection here phone with more than one or two 


52 / OCTOBER 2013 / WWW.LINUXJOURNAL.COM 


COLUMNS 


connections. | still hadn’t given up 

on full streaming, so my first attempt 
at “Global BirdCam” was to re-encode 
the phone's video on my Linux server, 
which would be able to handle 

far more connections than an old 
Android handset. 

Thankfully, VLC will run headless 
and happily rebroadcast a video 
stream. Getting just the right 
command-line options to stream 
mjpeg properly proved to be a 
challenge, but in the end, this long 
one-liner did the trick: 
cvlc http://PHONE_IP:8080/videofeed --sout \ 
‘'#std{access=http{mime=multipart/x-mixed-replace; \ 
boundary=7b3cc56e5f51db803f790dad720ed50a}, \ 


mux=mpjpeg,dst=0.0.0.0:2000/}' 


The cvlc alias just starts VLC 
headlessly. The mime and boundary 
stuff took the longest to figure out. 
Basically, | had to get that right, 
or Web browsers would just try to 
download a file instead of playing 
a stream. This method did work, 
actually, and | could connect multiple 
clients to the server on port 2000 
and get the remuxed stream without 
overtaxing the phone. (The phone 
served out only the single feed to 
the server, and the server is far more 
robust.) Unfortunately, that didn’t 
solve my bandwidth issue. 
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My Flipbook Solution 

Although the VLC solution did 
work, it didn’t really fit my needs. | 
couldn't stream to the Internet due 
to lack of bandwidth, and even if | 
could, my server could handle only a 
handful of clients before it petered 
out as well. What | ended up with 
as my final solution is rather elegant 
and very efficient. 

You may recall | said the Android 
application allows for high-resolution 
snapshots to be taken along with 
a direct video feed. Rather than 
streaming video, | figured if | took a 
high-res photo every second, | could 
get a far better image and also save 
boatloads of bandwidth. | still wanted 
a video-like experience, so | concocted 
a handful of scripts and learned some 
JavaScript to make a sort of “flipbook 
video” stream on a regular Web page. 
This was a two-part process. | had to 
get constantly updated photos, plus 
| had to build a Web page to display 
them properly. 


Step One: Getting the Photos 

My first instinct was to use a cron job 
to fetch photos regularly from the 
Android phone. Because cron jobs run 
only every minute, | dismissed my first 
plan right away. | didn’t need full- 
motion video, but “One Frame Per 
Minute” is pathetic by any standard. 
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Listing 1. bird_update Script 


#!/bin/bash 
while true 
do 
bird_getphoto 
Silene 


done 


Listing 2. bird_getphoto Script 


#!/bin/bash 


#Variables -- change to fit your needs 


ORIGINAL _PHOTO=/dev/shm/birdtemp. jpg 


MODIFIED _PHOTO=/dev/shm/birdmod. jpg 


FINISH PHOTO=/dev/shm/birds.jpg 


CAMERA_IP=192.168.1.201 


PHOTO_URL=http://192.168.1.201:8080/photo. jpg 


if eval "ping -c 1 $CAMERA_IP > /dev/null" 


then 


/usr/bin/wget -r --timeout=10 --quiet -O \ 


$ORIGINAL_PHOTO \ 
"$PHOTO_URL" 


convert $ORIGINAL_ PHOTO \ 


-quality 70% \ 
-pointsize 64 \ 
-fill white \ 
-annotate +675+60 " 
$MODIFIED PHOTO 


rm $ORIGINAL_PHOTO 


“oleic ar"GSi erailssas: Ya 7 


mv $MODIFIED_ PHOTO $FINISH_PHOTO 


fi 
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| ended up making a few 
Scripts, one of which | 
launch via rc.local on system 
boot (Listings 1 and 2). 

The first script, 
bird_update (Listing 1), is 
started via rc.local on my 
server. | could have called 
the larger script directly 
from rc.local and had it 
loop, but this way, | could 
make a change to the 
main script (bird_getphoto, 
Listing 2) and not worry 
about restarting the rc.local 
stuff. bird_update runs 
bird_getphoto, sleeps for a 
second and starts over. That 
means if | make a change 
to bird_getphoto, the 
changes would be reflected 
on the next iteration of 
the loop, with nothing to 
Start over. Since | tweaked 
bird_getphoto about 
6,000 times, this method 
was ideal. 

The bird_getphoto is 
what does the “dirty work” 
so to speak. Stepping 
through the commands 
should be fairly self 
explanatory, but basically: 


1. See if phone is on-line. 
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2. Get photo from phone (with how long it took me to fiddle around 


a short timeout—by default, 
timeout is absurdly long, and an 
occasional hiccup shouldn't stall 
the entire system). 


. Store photo in ramdisk. | did this 
to save on hard drive wear. | figure 
I'm saving a file every second, 

and it’s silly to do that to spinning 
media every time. 


. Compress and annotate the 
photo. At first | had my phone in 
portrait mode, so | had to rotate 
as well. The convert program, 
which is part of the ImageMagick 
package, is very powerful. | added 
a timestamp to the photo, mainly 
because | could. 


. After download and conversion is 
complete, mv the temporary file to 
the live image. | added this extra 
step, because if convert stores 
directly to the final filename, it 
gets displayed as a corrupt image 
if the Web server tries to serve 

it out during the conversion 
process. The mv command is almost 
instantaneous, so | haven't seen 
any weird corruption after adding 
the extra step. 


I'm almost embarrassed to admit 


with commands, ideas, loops and 
so forth before coming up with the 
scripts shown here. As with all my 
articles, please feel free to change 
and/or improve on my ideas to best fit 
your needs. These scripts have been 
running smoothly for weeks now, 
and they seem to be fairly bulletproof 
when it comes to network failures 
and such. Getting the photos 


regularly updated, however, was only 


half the problem—as it turns out, 
the easier half. 


Step 2: JavaScript, and Breaking 
the Internet 

In order to display the constantly 
updated bird photos, it was easy 
enough to create a symbolic link from 
/dev/shm/birds.jpg to /var/www/birds/, 
where my Apache virtual host folder 
was located. | created a simple HTML 
file with an img tag, and | could see my 
bird feeders from anywhere. In order 
to get a refreshed image, however, | 
had to refresh the entire Web page. It 
worked, but It was ugly. | had to reach 
out for some JavaScript help. 

Before getting to the final HTML 
file, it’s important to explain that 
while getting JavaScript to refresh a 
single image on a page isn’t terribly 
difficult, browsers are designed to 
cache as much as possible, so making 
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Listing 3. birds.html 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 


="http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 


<html xmins="http://www.w3.org/1999/xhtm1"> 


<head> 
Sepelerine irc. Of Mor. Sele les 
<script type="text/javascript"> 
refreshImage = function() 

{ 


img = document.getElementById("cam") ; 


img.src = "http://example.com/birds.jpg?rand=" 


w+ Math.random() ; 


} 


</script> 


<meta http-equiv="Content-Type" content="text/html ; 


=»charset=iso-8859-1" /> 


</head> 


<body onload="window.setInterval(refreshImage, 


<center> 


<img style="width: 100%;max-width: 2048px" 


N2)5 0) ieee 


=»src="http://example.com/birds.jpg" id="cam" /> 


lotr /e 


<small><em>This should constantly refresh</em></small> 


</center> 
</body> 
</html> 


sure the image was actually fetched 

from my server every couple seconds 
proved challenging. Listing 3 shows 

my final HTML file. 

A large part of the top of the file 
shown in Listing 3 is just defining 
the specific HTML standards in use. 
I'll be honest, most of it is over my 
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head. The key part of the script is 
the JavaScript code, which defines an 
action for an image with a specific 
ID. You can see the ID Is “cam” in 
the JavaScript and in the img tag 
below. The peculiar part of the script 
is the bit of random info after the 
photo URL. That’s actually the part 
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of the script that not only reloads 2500 milliseconds as the refresh time, 
the image every 2.5 seconds, but because it seems to work from most 
also loads the image with 

a ?rand=RANDOMNUMBER &) O F .d73%m 3:08 PM 


at the end. That’s basically 
me fooling the browser into 
thinking there is a new image 
to download every time, so 

| don’t get shown a cached 
image. There are several ways 
to do such a thing, but this 
proved to be the simplest and 
most cross-browser-friendly in 
my testing. There is concern of 
filling up caches or buffers on 
the server, but so far | haven't 
experienced any issues. 


The End! Or Is It? 

To fulfill my personal needs, 
the bash scripts and the bit 

of JavaScript really did all | 
needed. | can view the BirdCam 
from multiple computers in 

my house, and even from the 
Internet. Each “video frame” 

is around 600K, so although it 
still uses significant bandwidth, 
it’s nothing like trying to 
stream full video. | have 
noticed that with slow cellular 
connections, sometimes the 


image freezes, because it tries Figure 5. With the ability to view BirdCam 
to refresh before the original remotely, | can get some great shots, even 
image Is loaded. | settled on when I’m not home! 
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locations (Figure 5). were worried about saturating my home 
If you visit my BirdCam now connection, fear not; | planned ahead. 

(http://birds.brainofshawn.com), 

you'll probably notice I’ve done a little Winter Is Coming 

more tweaking. I’ve added a query If you set up a similar Webcam, I'd love 

to the local weather station, and | to hear about it. You’re also welcome to 

added the current temperature to the watch the exploits of my bird obsession 

annotation. The big change, however, as winter approaches. The bubbling 

is one you hopefully shouldn’t notice. bird bath soon will be replaced with a 


Because | knew I'd be 
sending this to tens of 
thousands of potential 
bird watchers, | figured 
| probably should scale 
my solution to the cloud. 
Granted, 5Mbit upload 
speed is decent, but not if 
100 people are trying to 
check out my backyard! 
My simple solution 
was to replace the 
sleep command in the 
bird_update script with 
an scp command that 
uploads the bird.jpg 
file to my Web hosting 
provider. | still try to be a 
good netizen and upload 
the actual file to the 
ramdisk on my provider's 
server, but with the 
jpg file being served 
from the cloud, I’m not 
worried about an influx 
of bird watchers. If you Figure 6. Bird water just tastes better. 
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heated version, and I'll be adding more 
suet and peanuts for the winter birds. 

If you happen to be watching, and see 
a cool bird, don’t hesitate to send me 
the photo! | had a visit from an Indigo 
Bunting one day that | saw via BirdCam, 
but that was when | was using an old 


iPhone, so the image is very poor quality. 


BirdTopia attracts more than just birds 
too. While the occasional squirrel is 
brave enough to visit, the most common 
non-aviary visitor is Zoey (Figure 6). 

| wish you an awesome weekend 
project! | have enjoyed playing with 
BirdCam almost as much as | enjoyed 
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making a MAME cabinet years ago. 
There’s just something about building 
with Linux that warms my heart.™ 


Shawn Powers is the Associate Editor for Linux Journal. 

He’s also the Gadget Guy for LinuxJournal.com, and he has an 

interesting collection of vintage Garfield coffee mugs. Don’t let 
his silly hairdo fool you, he’s a pretty ordinary guy and can be 
reached via e-mail at shawn @linuxjournal.com. Or, swing by 

the #linuxjournal IRC channel on Freenode.net. 
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NEW PRODUCTS 


NVIDIA CUDA 


Version 5.5 is the latest and greatest iteration of NVIDIA 
CUDA, NVIDIA's parallel computing platform and 


programming model that harnesses the power of GPUs. NVIDIA. 


CUDA 5.5, sayeth NVIDIA, provides programmers with = 
a robust, easy-to-use platform to develop advanced CU DA 


science, engineering, mobile and HPC applications on 


x86 CPU-based systems, and now on ARM-based ones 

as well. Beyond native support for ARM platforms, CUDA 5.5 delivers a number of 
new advanced performance and productivity features, including enhanced Hyper-Q 
support, MPI workload prioritization, and new guided, step-by-step performance 
analysis and fast cross-compile on x86. The latter feature enables developers to 
compile ARM code on fast x86 processors and transfer the compiled application to 
ARM. The v5.5 release also offers a full suite of programming tools, GPU-accelerated 
math libraries and documentation for both x86- and ARM-based platforms. 
http://www.nvidia.com 


Gumstix’s Geppetto Platform 


Gumstix continues to add fire power and options to 
Geppetto, the company’s modular, drag-and-drop platform 
for designing and building customized single-board Linux 
solutions. The most recent enhancement to Geppetto 
involves the addition of the Texas Instruments Sitara 

wg AM3354 processor, which Gumstix says will offer more 

Si flexibility to users and raise Geppetto's ability to enable 

GuMStIX® a rapid go-to-market strategy for its customers. While 
designing a board using Geppetto, users simply drag and 
drop the processor onto a board and then connect the desired features to implement 
it. Fully assembled single-board computers are ordered at the touch of a button and 
arrive within 20 business days. Furthermore, notes Gumstix, Geppetto’s support for 
the Yocto Project build system makes it easy for developers to create a complete, 
portable solution with minimal time and effort. 
http://geppetto.gumstix.com 
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Dan McCreary and Ann Kelly’s 
Making Sense of NoSQL 
(Manning Publications) 


NoSQL tools like MongoDB, Neo4j and Redis take innovative 
approaches to the unique problems of handling data in modern 
distributed and Web-based systems. The new book, Making 
Sense of NoSQL: A guide for managers and the rest of us by Dan 
McCreary and Ann Kelly, is a resource for learning about NoSQL solutions. According to 
publisher Manning Publications, the book clearly and concisely explains the concepts, 
features, benefits, potential and limitations of NoSQL technologies. Using examples and 
use cases, illustrations and plain, jargon-free writing, this guide shows how one can 
assemble a NoSQL solution to replace or augment a traditional RDBMS effectively. After 
reviewing database concepts alongside the new NoSQL patterns, authors McCreary and 
Kelly explore topics including Big Data, search, reliability, business adaptability, cloud 
computing, large CPU-count data centers and customized solutions. 


Making Sense of NoSQL 


http://www.manning.com 


Chris Strom’s 3D Game itn 
Programming for Kids a oe 
(Pragmatic Programmers) comes 


What's even better than playing games? Creating your own, of 
course. And thus you shall be so empowered if you digest the 
contents of Chris Strom’s new book 3D Game Programming 
for Kids: Create Interactive Worlds with JavaScript. Targeted at 
younger readers, Strom’s book illustrates how to create 

on-line games. Using nothing more than a browser and the language of the Web, JavaScript, 
readers will learn programming and visualize cool, 3-D results as they type. To make 
things easier for beginners, the kid-friendly ICE Code Editor was created especially for this 
book. Want a red donut? Make hundreds of them, spinning around like crazy, right next 
to the entered code. Readers can create games quickly by focusing on the project-based 
lessons. If they want to go further and understand the theory or mathematical functions, 
they can turn to the chapters that explain the programming concepts. 
http://www.pragprog.com 


g Chris Strom 


Edited by F Falmida ¥. Rashid 
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Directory Wizards 
Inc.’s UnitySync 
Directory Wizards Inc. 


Into the big Linux tent we SOLUTIONS FOR YOUR DIRECTORY NEEDS 

welcome Directory Wizards, 

whose UnitySync solution is now available on the Linux platform. UnitySync is a centralized 
service that synchronizes data between directories so that organizations enjoy a unified 
view of their disparate directories. Our sources at Directory Wizards say that UnitySync can 
scale from small directories with hundreds of objects to enterprise directories consisting 

of hundreds of thousands of objects without requiring extensive training or installation/ 
configuration time. UnitySync users can synchronize account information between different 
directories so that each directory contains a unified view of the other non-connected 
directories. In addition, users can define authoritative data sources, enabling one system to 
update individual attributes of existing objects of another. No scripting, programming or 
extra databases are required. The Windows Intel 32-bit platform also is supported. 
http://www.dirwiz.com 


= a ===,  Coraid ZX4000 File 
Storage Appliance 


Public cloud scalability, economics and 
resilience models are three macroforces 
affecting IT. Storage specialist Coraid’s response to these trends is the new ZX4000 
File Storage Appliance, a storage building-block solution for both enterprise and cloud 
deployments that combines Flash performance, multi-petabyte scale and distributed 
resilience. Coraid suggests that the ZX solution's unique architecture allows for a 
potentially limitless pool of elastic, shared, block storage that easily scales performance 
via the addition of more ZX appliances. The ZX4000 can be deployed in a resilient 
architecture that offers protection against up to three shelf or drive failures while 
retaining high storage efficiencies of around 80%. This enterprise-class storage 
solution, says Coraid, is available at a cost comparable to consumer-grade public cloud 
services and at a fraction of the cost of legacy NAS storage. Since its introduction 

in 2012, the ZX product line has been deployed by customers in a wide variety of 
applications including backup, public and private clouds, and media. 
http://www.coraid.com/products 


Coraid EtherDrive SRX 
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— m The Document 
% = Foundation’s 


LibreOffice 


The Document Foundation 
proudly calls its new 
LibreOffice 4.1 office suite “not only the best but also the most interoperable free office 
suite ever”. The 4.1 milestone release features a large number of improvements in the 
area of document compatibility, which increases the opportunities of sharing knowledge 
with users of proprietary software while retaining the original layout and contents. 
Numerous improvements have been made to Microsoft OOXML import and export filters, 
as well as to legacy Microsoft Office and RTF file filters. Other new interoperability- 
focused features include font embedding in Writer, Calc, Impress and Draw and import 
and export functions new in Excel 2013 for ODF OpenFormula compatibility. 


http://www.libreoffice.org 


MWR InfoSecurity’s drozer 


= 
The Android security testing framework ({ / je C 


formerly known as Mercury—and now 

called drozer—was released recently by MWR InfoSecurity. With drozer, 
companies using Android mobile devices now can safeguard their assets and 
IT infrastructure by running full, dynamic security assessments. A new drozer 
feature is the ability to compromise Android devices through publicly available 
exploits, something that helps organizations understand how a technical 
vulnerability on a mobile device can become a real threat to their business. 
Drozer unifies these publicly available exploits into a single framework and 
improves the quality of the exploitation code and payloads available to the 
penetration tester. Drozer provides support for any Android device running 
Android 2.1 and beyond, covering 99% of the devices in the market. The 
open-source tool is available to download from the MWR Labs Web site. 
http://www.mwrinfosecurity.com 


Please send information about releases of Linux-related products to newproducts@linuxjournal.com or 


New Products c/o Linux Journal, PO Box 980985, Houston, TX 77098. Submissions are edited for length and content. 
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FEATURE Be a Mechanic...with Android and Linux! 


BEA 
MECHANIC... 


with ANDROID and LINUX! 


CHECK 


“Check Engine Soon”—that little orange light on your car’s 
instrument panel is possibly one of the more annoying things about 
modern automobiles. Ever had it pop on during a trip and wonder 
whether it was just something mundane, like your gas cap being loose, 
or whether it’s something deathly serious and a piston could come 
shooting out the side of your engine block at any time? Well, thanks to 
an inexpensive little piece of hardware and an Android tablet, I'll help 
you decode that little orange light in your car. 


BILL CHILDERS 
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he human race has had 
automobiles for more than 
100 years now, but we've 

had computer monitors and control 
engine operation only for around 

30 years or so. The first computer 
controls were primitive, hard to work 
with and expensive. Each automotive 
manufacturer had its own computer 
systems, protocols, connectors and 
trouble-code definitions. | worked as 
a mechanic during the late 1980s and 
early 1990s, and | remember those 
systems well—not fondly, of course, 
but well. Some of those systems 
required you to do crazy things like 
jump a connector with a piece of wire, 
then turn the key on and off three 
times and observe the Check Engine 
light as it flashed on and off. You'd 
have to count the number of flashes 
accurately and then look up the 
“trouble code” that flashed in 

a service manual, and you might get 
a clue as to what was wrong with 
the vehicle. Those early diagnostic 
systems made seasoned mechanics 
who were used to troubleshooting 
the machinery of an engine rather 
than its electronics shudder 

with trepidation. Over time, the 
manufacturers made the systems 
better. The Society of Automotive 
Engineers made the connector, 
protocol and trouble codes a standard 


in 1996, and with that, we’ve got 
the system in place today: OBD-II 
(Onboard Diagnostics, 2nd revision). 


OBD-II Basics 

Any car sold in the United States 

after 1996 uses the OBD-I] computer 
system, so the majority of cars on 

the road today have this system. 
Thanks to OBD-Il’s standardization and 
age, lots of tools have been released 
to work with the system. Because 
OBD-II defines the connector and 
protocol, that means you need both a 
hardware device to interface with the 
connector and some software to speak 
the protocol. 

The hardware | use is the Soliport 
ELM327 Bluetooth OBD-II Scanner 
(see the Amazon link in the Resources 
section of this article). It’s a very 
inexpensive (less than $20) dongle 
that plugs in to the OBD-II port under 
your dashboard, draws its power 
directly from the car and converts the 
OBD-II-specific signals to serial-over- 
Bluetooth. There are other OBD-II scan 
tools on the market. Some are just 
plain-old cables to hook straight into 
a computer's RS-232 serial port, and 
others are as fancy as full-on bridges 
to a Wi-Fi network. And, there are 
other manufacturers of Bluetooth 
OBD-II scan tools, but just make sure 
whatever you get is based on the 
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ELM327 chipset. 
u Another piece of 
>See 3 hardware you'll need is a 
interyace computer of some kind. 
O0000 
Any Linux-powered laptop 
with Bluetooth will suffice, 
but the form factor is kind 
of clunky when you’re 
dealing with a cramped 
automotive cockpit. (See 
the Using a Laptop to 
Scan Your OBD-II System 
sidebar if you want to use 
a laptop.) My personal 
preference is to use an 
Android device to interpret 
the signals coming from 
the OBD-II system in the 
car. | use a Nexus 7 tablet 
for this, but any Android 
device should work. I’ve 
used a Motorola Droid 
RAZR and the very first 
HTC G1 Android phone 
for this as well. 
Software-wise, my choice 
for this on Android is 
Torque, an excellent app 
that not only can collect 
all the OBD-II stats, but 
also graph and log them 
in myriad ways. (There's 
also a free version, Torque 
Figure 1. Tools of the Trade: a Nexus 7 Tablet and a Lite, that has a fair deal of 
Soliport Bluetooth OBD-II Scanner the functionality of the full 
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Although it’s possible to use a laptop to do the same duty as an Android device, 
it’s a little more involved, as the Bluetooth protocol stack on a Linux laptop 
requires some more massaging than simply pairing up an Android device. 
However, if you’re comfortable with the command line and Bluetooth commands 
like rfcomm, it’s absolutely possible, and there are some good OBD-II packages 
like pyobd and openobd. You won’t get some of Torque’s value-add features, like 
accelerometer and GPS integration, but you still can use the laptop for diagnostic 
purposes and data logging. 


In the December 2008 issue of LJ, | wrote an article called “Hacking the Nokia 
Internet Tablet”, and | talked about ways to hack and extend the Nokia N800 
tablet. It turns out there’s an application for the N800 and N810 called Carman 
that was designed to work with wired OBD-II adapters, but it works just fine with 
the Soliport Bluetooth Scanner. Carman used to be in the Maemo repositories. 

| no longer have a working N800, so | can’t check that now, but when my N800 

did work, | used it a few times to diagnose the car. So, if you’ve got a Nokia device 


sitting in a drawer gathering dust, pull it out and put it to use! 


version.) Grab either one from the perhaps, as it’s very easy to make a 
Google Play store. mess of things). Flashing your car’s 
Note that this solution is for read- computer with a new fuel curve or 
only access to the OBD-II system in ignition timing map is a nontrivial 
the car. You can’t modify the running exercise that requires an adapter with 
parameters of the vehicle with this different voltage levels and different 


adapter, unfortunately (or fortunately, software. So, don’t worry about 
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breaking your 
car with this 
solution—you’re 
just “peeking 
under the 
hood”. 


Using 
Torque and 
the Soliport 
Bluetooth 
Adapter 
The Soliport 
adapter comes 
with a little 
CD-ROM in the 
box, but it’s not 
required for use 
with an Android 
device. To get 
Started, you first 
need to find the 
OBD-II port in 
your car. In most 
cars sold in the 
United States, 
the port is under 
the dash on the 
driver's side of 
the car. Find the 
port, and plug 
the Soliport in 
to it. 

Next, start the 


TORQUE 


at Management Diagnostics and Tools 


Profile: 2009, Pontia... 


VEEN 

Ni Ae 

Realtime 
Information 


Graphing 


Test 
Results 


car, because the Figure 2. The Torque Home Screen 
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Adapter 
Status 


OBD-II port isn’t powered until the 
car's ignition is on. (Make sure your 
garage door Is open, please. | don’t 
want to receive hate mail from your 
relatives on how you suffocated from 
carbon monoxide poisoning!) Next, 
you need to go through the standard 
Bluetooth pairing process to pair 
your Android device to the Soliport 
adapter. (The pairing code is 1234 if 
you can’t find it in the instructions— 
coincidentally, it’s the same 
combination that’s on my luggage.) 

Once you've got your Android 
device all paired up to the Soliport, 
you're ready to fire up Torque. Start 
Torque on your Android device, and 
you'll be greeted with the Torque 
main screen. 


Setting Up Torque 
Now that you have Torque up, select 
the little “settings” slider on the 
bottom left of the screen, and select 
“OBD2 Adapter Settings”. Set the 
connection type as Bluetooth, and 
choose the Soliport if prompted. Go 
back to the main settings screen and 
select your desired units (Imperial or 
Metric), and any other preferences 
you choose, then flip back to the 
Torque main screen. 

Next, you're going to create a 
“profile” for your vehicle. Select the 
settings slider from the main screen 


as before, then select “Vehicle 
Profile” and “Create new profile”. 
Then, fill in the pertinent information 
about your vehicle. This information 
is used by Torque to compute 

things that can be calculated, like 
horsepower, fuel economy and other 
metrics. When you’re done, go back 
to the main screen. 


Checking for Fault Codes 
Let's start by doing basic diagnostics 
on your car. From the main screen, 
select Fault Codes, then press the 
large magnifying glass to start a scan 
of your car’s computer for trouble 
codes. If your Check Engine light is 
on, you'll probably find your issue 
represented as a code here. My 
father’s 2001 Chevy Silverado pickup 
was showing a Check Engine light, 
and | ran a quick scan on it with 
Torque. It resulted in a trouble code of 
P1416. A quick Google search of that 
trouble code showed that it was the 
Secondary Air Valve, Bank 2. It turned 
out that was a little smog system valve 
right on top of the engine, on the 
passenger side. Amazon.com had that 
particular part for $37, and we had it 
at his house in two days. 

| had the Check Engine light on my 
wife’s Durango pop on not long after, 
and | used the tool to scan her car. 
Her car came back with a P0440 code, 
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which means 
“Evaporative 
Emission 
Control System 
Malfunction”. 

| searched a bit 
more on the 
Internet and 
found that the 
most common 
cause of this 
code is a broken 
or mis-installed 
fuel filler cap. It 
turned out that 
was exactly the 
case—her fuel 
filler cap wasn’t 
tightened all the 
way. | tightened 
the cap and 
cleared the code 
via the Torque 
app, and it never 
returned. 


Getting 
Performance 
Data 

Those two cases 
listed above 
more than paid 
for the cost of 
the Soliport 
adapter and the 
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Figure 3. Torque’s Virtual Instrument Panel 
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Torque application, but Torque can do 
so much more. Torque can pull data 
from sources other than your OBD-II 
sensors. It also can poll your Android 
device’s accelerometer and GPS. 

This means it can do performance 
calculations, such as 0-60 mph time 
(or 0-100 kph time), 1/4 mile time or 
even horsepower calculations. This 
requires that you get your car’s data 
entered correctly into the vehicle 
profile during setup time, particularly 
the vehicle weight (including your 
weight as driver, and any other stuff 
you may have inside the car). If you do 
performance testing, make sure you're 
doing it safely—and don’t violate any 
laws in your locality. 

However, | think one of the coolest 
things that Torque and the Soliport 
adapter can do is they can act as 
an auxiliary instrument panel for 
your car. Any bit of information that 
passes through the OBD-II sensors can 
be logged, graphed or placed ona 
digital dial. You can pick and choose 
how you want that information 
presented as well—including the size 
and position of the graphs and dials. 
This information can be extremely 
valuable, for instance, displaying the 
current engine manifold vacuum. As a 
general rule, under cruise conditions, 
higher manifold vacuum means higher 
fuel economy, so having this gauge up 


can be handy on long trips. 

Torque also has other features, 
like the ability to log your data for 
future analysis. It also can graph that 
data and correlate it to your GPS 
position and accelerometer data. 
This can be useful if you happen to 
be an amateur racer and would like 
to get information about your car’s 
performance at certain points on the 
racetrack. Most people won't need 
that ability, but it’s nice to know that 
the developer of Torque thought that 
out. All the data necessary to do those 


LinuxJournal.com 
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Library 


www.linuxjournal.com/whitepapers 


WWW.LINUXJOURNAL.COM / OCTOBER 2013 / 71 


FEATURE Be a Mechanic...with Android and Linux! 


calculations is there, it just needs to 
be glued together. 


Closing 

Computer control systems in cars used 
to be mysterious, overly complicated, 
finicky pieces of technological voodoo 
to even the most seasoned mechanic. 
Scan tools were proprietary and cost 
thousands of dollars, and mechanics 
needed a special tool for each car 
manufacturer. With the advent of 
OBD-II and inexpensive computers, it’s 
now easy to de-mystify and diagnose 
your car. Don’t let the strange terms 


Resources 


Soliport ELM327 Bluetooth OBD-II Scanner: 


fool you—like the computers you're 

already familiar with, an automobile 

is just a collection of technology and 
machinery, and you can troubleshoot 
it just like a computer.m 


Bill Childers is an IT Manager in Silicon Valley, where he lives 
with his wife and two children. He enjoys Linux far too much, and 
probably should get more sun from time to time. 


TTT EEE 
Send comments or feedback via 
http://www.linuxjournal.com/contact 
or to ljeditor@linuxjournal.com. 


http://www.amazon.com/Soliport-Bluetooth-OBDII-Diagnostic-Scanner/dp/BOO4KLOI9I 


Torque Android OBD-II Scanner App: 


https://play.google.com/store/apps/details?id=org.prowl.torque&hl=en 


Torque Lite (FREE) Android OBD-II Scanner App: 
https://play.google.com/store/apps/details?id=org.prowl.torquefree&hl=en 


OBD-II Trouble Code Lookup: http://www.obd-codes.com/trouble_codes 


PyOBD Home Page: http://www.obdtester.com/pyobd 


OpenOBD Home Page: 


http://sourceforge.net/apps/mediawiki/openobd/index.php?title=OpenOBD 


Carman on the Nokia N800: 


http://tabletblog.com/2007/02/carman-bluetooth-elmscan-5-and-n800.html 
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New for 2013: The LISA Lab Hack Space! 


Register by October 15 and save. Additional discounts are available! 
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FEATURE Create a Mini PC or Server with Olimex’s Olinuxino A13/A13Micro 


_ Createa 
Mini PC or Server 
with Olimex’s 

Olinuxino 
A13/A13Micro 


STEP-BY-STEP 
INSTRUCTIONS 
ON HOW TO CREATE 
A PERSONAL COMPUTER 
OR EVEN A SMALL SERVER 
WITH THIS GREAT 
EMBEDDED SYSTEM 
FOR LESS THAN $80 US! 


RONALD KURNIAWAN 


limex is a Bulgarian 
company known for 

its innovative hobbyist 
products. It has a wide 
array of microcontroller- 
based products, ranging 
from the small Arduino clones to 

the very able system that has the 
Allwinner A13 microcontroller as its 
brain. In this article, | describe how 
you can create a working Linux system 
for the Olinuxino A13 and Olinuxino 
A13Micro from scratch. 

Let’s begin by obtaining and 
compiling the kernel, creating the 
U-Boot system, preparing the root 
filesystem and getting the necessary 
packages to create a comfortable 
minimal computing environment. 

At the end of this article, | also 
explain how to install a compact 
desktop environment. 

| am using Ubuntu 12.04 (Precise 
Pangolin) for my build system. Any 
Debian-based system users should be 
able to follow the instructions in this 
article with relative ease. Before you 
begin, you should create a directory 
under your home directory to contain 
all your work. | am going to call mine 
“A13System”. 


What Are Arm and eabihf? 
As you progress further into the 
article, you will encounter the terms 


Arm and eabihf more than once. 

Let me clarify those terms in order 

to avoid confusion with other terms 
that you might encounter if you 
decide to go further into the world of 
cross-compilation. 

Arm is a general name for a family 
of microcontroller architectures 
designed by ARM Holdings, a 
British company. You can find Arm 
microcontrollers inside most portable 
modern gadgets, ranging from 
mobile phones, Nintendo DS portable 
game consoles to Apple iPhone and 
Apple TV. ARM Holdings does not 
manufacture these microcontrollers; 
rather, it licenses the designs to other 
companies. These companies then add 
their own “secret recipes” into the 
designs and then manufacture and sell 
the finished microcontrollers. This is 
why there are so many variants of Arm 
architecture and so many companies 
that produce Arm microcontrollers. 

EABI stands for Embedded 
Application Binary Interface. It 
specifies the low-level conventions 
for embedded software 
application. When it comes to Arm 
microcontrollers, they come in many 
sizes, ranging from very small to 
large. The smaller variants don’t have 
the necessary memory or power to 
process floating-point computation 
on the hardware itself, thus making it 
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necessary to do it by software. These 
variants are called Arm soft float. 
There are other variants that can 
process the floating-point calculation 
by hardware, like vector floating 
point (vfp). These two EABIs (soft 
float and vfp) are what is usually 
known as armel. A newer EABI 
that targets the higher end of Arm 
microcontrollers with more efficient 
floating-point instructions than vfp is 
called hard float, thus armhf. 
Olimex’s A13WiFI, A13 and 
A13Micro boards are powered by the 
Allwinner A13 Arm microcontroller, 
which are based on ARMv7/ design. 
ARMv/7, as with the newer ARMv8, 
fully supports armhf. 


Prerequisites 

You can find all the necessary 

URLs for file downloads and other 
information in the Resources section 
of this article. You need to install the 
following programs before you can 
commence the build process: 


@ build-essential. 

™ gcc-4.6-arm-linux-gnueabihf (the 
version might vary from one distro to 
another; the latest | came across at 


the time of this writing is version 4.7). 


M@ ncurses-dev. 
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™ uboot-mkimage. 
@ git. 
™ debootstrap. 


™ debian-archive-keyring (if you 
decide later that you want to use 
Debian rootfs). 


M gemu-user-static. 


Once you finish installing the 
prerequisites, you then need to create 
several softlinks in the same directory 
where gcc-4.6-arm-linux-gnueabihf is 
installed (in my case, it is located in 
/usr/bin). Use the which command to 
find the installation directory: 


$ which arm-linux-gnueabi-gcc-4.6 


Next, create softlinks for 
arm-linux-gnueabiht-gcc-4.6, 
arm-linux-gnueabiht-gcov-4.6 and 
arm-linux-gnueabihf-cpp-4.6: 


$ sudo ln -s /usr/bin/arm-linux-gnueabihf-gcc-4.6 \ 
/usr/bin/arm-1linux-gnueabihf-gcc 

$ sudo ln -s \ 
/usr/bin/arm-linux-gnueabihf-gcov-4.6 \ 
/usr/bin/arm-1linux-gnueabihf-gcov 

$ sudo ln -s /usr/bin/arm-linux-gnueabihf-cpp-4.6 \ 


/usr/bin/arm-1linux-gnueabihf-cpp 


Preparing the Kernel and U-Boot 
The good people at Linux Sunxi are 
kind enough to share the kernel 

and U-Boot code tailored to run on 
Allwinner chips. You have the option 
of getting and compiling version 

3.0 or 3.4 of the Linux kernel. The 
compilation procedures are similar. 
For the purpose of this article, | am 
using kernel version 3.4. Get the 
kernel and U-Boot source from Linux 
Sunxi’s GitHub repository: 


$ git clone -b sunxi-3.4 
https://github.com/1linux-sunxi/linux-sunxi.git 
$ git clone -b sunxi 


https://github.com/1linux-sunxi/u-boot-sunxi.git 


Let’s compile U-Boot first. 
Depending on the target system 
(A13 or A13Micro), go to the 
U-Boot directory and issue the 
following command: 


$ make al13-olinuxino \ 
CROSS _COMPILE=arm-1inux-gnueabihf - 


OF: 


$ make a13-olinuxinom \ 
CROSS COMPILE=arm-1inux-gnueabihf - 


Note: the dash (-) at the end 
of the commands are not typos. 
After the make process finishes, 


if everything goes correctly, you 
should end up with u-boot.bin and 
spl/sunxi-spl.bin. 

Go to the kernel source directory. 
Check the configuration directory 
($KERNEL_DIR/arch/arm/configs) 
for the A13 configuration file 
(a13_defconfig) or A13Micro 
(a130m_defconfig). If you do not 
have the configuration file for 
A13Micro (which is usually the 
case), you can find the download 
URL in the Resources section. 

Now you need to check the 
configuration file for a specific line. 
| learned the hard way that without 
this line, the compilation will fail. 
Add the following line to your 
configuration file if it does not exist 
or uncomment it: 


CONFIG _GPIOLIB=y 

Once again, depending on the 
target system, issue one of these 
sets of commands to compile the 


kernel source: 


$ make ARCH=arm al3_defconfig 
$ make menuconfig 


OP: 


$ make ARCH=arm al3o0m_defconfig 
$ make menuconfig 
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viper@moblinux: ~/OLINUXINO/al3micro/sunxi-3.4 


Linux/arm 3.4.43 Kernel Configuration 


Arrow keys navigate the menu. 
Highlighted letters are hotkeys. 
<M> modularizes features. 
for Search. Legend: [*] built-in 
(-) 
System Type ---> 
[ ] FIQ Mode Serial Debugger 
Bus support ---> 
Kernel Features 
Boot options ---> 
CPU Power Management ---> 
Floating point emulation 


---> 


<Enter> selects submenus --->. 

Pressing <Y> includes, <N> excludes, 
Press <Esc><Esc> to exit, <?> for Help, </> 
{ ] excluded 


<M> module < > 


---> 


Userspace binary formats ---> 
i ower management options ---> 


[*] Networking support 
v(+) 


---> 


< Exit > 


< Help > 


Figure 1. Selecting Power Management Options 


The last step allows you to 
customize your kernel. In order 
to avoid a long and painful 
debugging process, always make 
Sure you are able to compile 
the minimal kernel (that means 
compiling without any options 
added) successfully first. Once you 
succeed, you can add more options 
to your kernel. Note any options 
you add to the kernel configuration, 
as it will aid you in figuring out 
which feature(s) does not work. 
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There is a special step you should 
adhere to if you are compiling 
the kernel for A13Micro boards. 
You need to remove the option to 
“Suspend to RAM and standby”, 
which is located under “Power 
Management options”. A13Micro 
boards do not support this option. 

If you are planning to use any of 
the board’s GPIO pins, make sure 
that you select “An ugly sun4i 
gpio driver” option under “Device 
Drivers” and “Misc devices”. 


viper@moblinux: ~/OLINUXINO/al3micro/sunxi-3.4 


-config - Linux/arm 3.4.43 Kernel Configuration 


Power management opttons 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > 


fi uspend to RAM and standb 
[ ] Run-time PM core functionality 
[ ] Log time spent in suspend 


< Exit >  < Help > 


Figure 2. Uncheck Suspend to RAM and Standby 


viper@moblinux: ~/OLINUXINO/al3micro/sunxi-3.4 
-config - Linux/arm 3.4.43 Kernel Configuration 


Device Drivers 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > 


Generic Driver Options ---> 
< > Connector - unified userspace <-> kernelspace linker 
< > Memory Technology Device (MTD) support ---> 
< > Parallel port support ---> 
1 Block devices ---> 
f Misc devices ---> 
SCSI device support ---> 
< > Serial ATA and Parallel ATA drivers ---> 
[*] Multiple devices driver support (RAID and LVM) ---> 
< > Generic Target Core Mod (TCM) and ConfigFS Infrastructure -- 


v(+) 


< Exit >< Help > 


Figure 3. Selecting Misc Devices under Device Drivers 
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viper@moblinux: ~/OLINUXINO/al3micro/sunxi-3.4 
-config - Linux/arm 3.4.43 Kernel Configuration 


Wireless LAN 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > 


--- Wireless LAN 

< > USB ZD1201 based Wireless device support 

[ ] Enable WiFi control function abstraction 

<> Broadcom 4329/30 wireless cards support 

<M> Broadcom 4330 wireless cards support 

<>  TEEE 802.11 for Host AP (Prism2/2.5/3 and WEP/TKIP/CCMP) 
< itp ealtek 8192C USB WiFi for SW 

<M> Realtek 8188E USB WiFi 

ae Realtek 8189E SDIO WiFi 

a Realtek 8723A SDIO WiFi 


v(+) 


< Exit > < Help > 


Figure 4. Realtek 8192C Driver as a Module 


viper@moblinux: ~/OLINUXINO/al3micro/sunxi-3.4 


-config - Linux/arm 3.4.43 Kernel Configuration 


Linux/arm 3.4.43 Kernel Configuration 
Arrow keys navigate the menu. <Enter> selects submenus --->. 
Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, 
<M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> 
for Search. Legend: [*] built-in [ ] excluded <M> module < > 


Co. ea. -. ee ey 
Bus support ---> 


Kernel Features ---> 

Boot options ---> 

CPU Power Management ---> 
Floating point emulation ---> 
Userspace binary formats ---> 


3 Power apenas "saga ---> 
* ‘ sje 


Device Drivers ---> 
File systems ---> 


v(+) 
< Exit > < Help > 


Figure 5. Networking Support Option 
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viper@moblinux: ~/OLINUXINO/al3micro/sunxi-3.4 


Networking options 


Arrow keys navigate the menu. 
Highlighted letters are hotkeys. 
<M> modularizes features. 
for Search. Legend: [*] built-in 


Packet socket 
Unix domain sockets 


> 
> 
> 
> 


PF_KEY sockets 


* CP/IP networking 


: multicasting 
: advanced router 


li 
[ 
[ 
[ 


A | 


: tunneling 
: GRE demultiplexer 


A 
v 


<= 
vont 

+ 
~~ 


< Exit > 


<Enter> selects submenus --->. 

Pressing <Y> includes, <N> excludes, 
Press <Esc><Esc> to exit, <?> for Help, </> 
[ ] excluded 


<M> module < > 


Transformation user configuration interface 


: kernel Level autoconfiguration 


< Help > 


Figure 6. Make sure that TCP/IP networking is selected. 


| also plan to use Olimex’s 
MOD-WIFI USB Stick Module? that 
adds the WI-Fi capabilities to the 
board. To do that, you need to 
include the driver for the module, 
which is called “Realtek 8192C USB 
Wifi for SW” and is located under 
“Device Drivers/Network device 
support/Wireless LAN”. You are 
welcome to experiment with other 
Wi-Fi devices. | can vouch that | 
successfully run the A13 board with 
the Netgear WG111v2 USB Wifi 


Stick module. The driver | used for 
this Wi-Fi device was “Realtek 8187 
and 8187B USB support”. 

You also have to make sure that 
TCP/IP is selected and included in 
the kernel. Tick Networking Support 
and press Enter to select it. 

Go inside Networking options 
and make sure that TCP/IP networking 
is selected. 

Once you are satisfied with your 
configuration, save it and go back 
to the command prompt. Issue the 
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following commands to compile the 
kernel and build the drivers: 


$ make ARCH=arm \ 

CROSS _COMPILE=arm-linux-gnueabihf- uImage 
$ make ARCH=arm \ 

CROSS COMPILE=arm-linux-gnueabihf- \ 
INSTALL_MOD_PATH=out modules 

$ make ARCH=arm \ 

CROSS _COMPILE=arm-linux-gnueabihf- \ 
INSTALL_MOD_PATH=out modules_install 


When the compilation finishes, 
you will end up with the kernel 
image in $KERNEL_DIR/arch/arm/ 
boot/ulmage and the modules and 
drivers in $KERNEL_DIR/out/lib/ 
modules/$KERNEL_VERSION. 

The next step is to prepare a 
minimal filesystem for your board. 
The easiest option I’ve found so 
far is by using the root filesystem 
from the Debian project or Ubuntu, 
as both distributions provide 
armhf binaries for the essential 
applications. | explain how to 
prepare both options next. 


Preparing the Filesystem: 
Debian Wheezy 

Start by creating a new directory 
for your root filesystem. For 

the sake of clarity, | call mine 
debian-rootfs. You'll use an 
application called debootstrap to 
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pull the basic filesystem structure 
from a Debian repository. You are 
free to use a repository that is closer 
to you, rather than the same one 

| use in this example. Enter the 
following as root or using sudo, 
inside your newly created directory: 


# debootstrap --foreign --arch armhf wheezy \ 
/home/user/A13System/debian-rootfs \ 


http://ftp.debian.org/debian 


Note that the resulting structure 
is still not a complete filesystem. 
The next step is to create a chroot 
system within your new directory. 
For those of you who are not 
familiar with chroot, this command 
effectively creates an isolated system 
within your “host” system: 


# cp $(which gemu-arm-static) \ 
/home/user/A13System/debian-rootfs/usr/bin 

# mount -t proc proc \ 
/home/user/A13System/debian-rootfs/proc 


# chroot /home/user/debian-rootfs /bin/bash 


I have no name!# ./debootstrap/debootstrap \ 


--second-stage 


Copy the qemu-arm-static binary 
into your root filesystem’s /usr/bin 
directory. The qemu-arm-static 
binary helps run the armhf binaries 
from your x86/64-bit systems. You 


also need to mount the 

host's proc filesystem into your 
chroot system. When you first 
get inside the chroot system, 

you might find a strange prompt 
greeting you (“I have no name!”). 
This is not a cause for concern, 
and you can safely disregard it. 
Once you are inside your chroot 
system, execute another call to 
debootstrap to complete the base 
system (with --second-stage). 

If you are curious whether you 
really are running an armhf system 
within your chroot system, issue 
the uname command to check. If 
you see something like “armv/|” 
somewhere in the output, it is 
an indication that your chroot is 
running the armhf system. 

The next step is to update your 
apt source list file. Within your 
chroot system, or using the build 
host's editor, go and edit the file 
/etc/apt/sources.list that resides 


inside your root filesystem directory. 


Add the following lines to this 
file (remember, you can use other 
Debian repositories as well): 


deb http://ftp.debian.org/debian wheezy main \ 
contrib non-free 
deb-src http://ftp.debian.org/debian wheezy main \ 


contrib non-free 


deb http://ftp.debian.org/debian wheezy-updates \ 
main contrib non-free 
deb-src http://ftp.debian.org/debian \ 


wheezy-updates main contrib non-free 


deb http://security.debian.org/ wheezy/updates \ 
main contrib non-free 
deb-src http://security.debian.org/ \ 


wheezy/updates main contrib non-free 


Preparing the Filesystem: Ubuntu 
If you are feeling adventurous, you 
always can try to debootstrap your 
Ubuntu root filesystem, just like | 
described in the previous section. 
(You also can find instructions on 
the Internet for that.) Here, let’s 
opt for an easier way and just 
download a ready-made minimal 
root filesystem provided by Ubuntu. 
Several packages are available, 
including Ubuntu 12.04, 12.10 

and 13.04. Make sure that you are 
downloading the armhf version of 
the root filesystem package. 

Create a directory for your 
Ubuntu root filesystem and extract 
the contents of the file you just 
downloaded into it. Your next move 
should be to edit /etc/resolv.conf and 
add your nameserver in there. Also, 
take a look at your sources.list file 
in /etc/apt/. You might want to add 
universe and multiverse at the 
end of each deb and deb-src line. 
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You should check the version 
number of your gemu-arm-static. 
Version 1.0.50 that comes with 
standard install of Ubuntu 12.04 
generates errors when running the 
following steps on my build system 
for the Ubuntu root filesystem. To 
solve the problem, | had to compile 
my own qemu-arm-static. | used 
version 1.0.91 (see Resources for 
the download URL of the source 
package). Do the following steps to 
configure and compile the binary, 
and copy the resulting qemu-arm to 
qemu-arm-static inside your Ubuntu 
root filesystem’s /usr/bin directory: 


$ ./configure \ 
--prefix=/home/user/A13System/qemu-arm-static \ 
--static --disable-kvm \ 


--target-list=arm-1linux-user 


$ make 


$ make install 


Finishing Touches for the 

Root Filesystem 

What you have so far is just a very 
basic filesystem. Now let’s improve 
it so that you have the tools 
required for a comfortable basic 
computing environment. Change 
the locales generated according to 
your own locale. All the processes 
described next are done inside the 
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chroot system: 


root@host:/# apt-get update 

root@host:/# apt-get install apt-utils ncurses-dev 
root@host:/# apt-get install dialog locales tzdata 
root@host:/# locale-gen en_AU en_AU.UTF-8 
root@host:/# dpkg-reconfigure locales 

root@host:/# dpkg-reconfigure tzdata 

root@host:/# apt-get install iputils-ping \ 
wpasupplicant dhcpcd5 sudo openssh-server ntp \ 
openssh-client 

root@host:/# apt-get install nano vim gettext \ 
bison automake autoconf 

root@host:/# apt-get install python rsyslog \ 


network-manager alsa-utils 


Now let’s configure Wi-Fi 
connectivity. I'm assuming that you're 
using a Wi-Fi USB adapter for your 
connectivity and that your wireless 
network connection configuration 
is using WPA for security. Change 
the steps accordingly for your 
configuration. Edit your /etc/network/ 
interfaces and add the following 
lines, changing the values as needed: 


auto wlan@ 

iface wlanO® inet dhcp 
wpa-ssid YOUR_ESSID 
wpa-psk YOUR_PASSPHRASE 


Next, if you want your bash shell 
to have autocompletion, edit /etc/ 
bash.bashrc and uncomment some 


of the lines to be something like 
the following: 


# Commented out, don't overwrite xterm -T 

# "title" -n "icontitle" by default. 

# If this is an xterm set the title to 

# user@host:dir 

case "$TERM" in 

xterm* | rxvt*) 
PROMPT _COMMAND='echo -ne \ 
"\Q33]0;${USER}@$ {HOSTNAME}: ${PWD}\007"' 


oD 


esac 


# enable bash completion in interactive shells 


if [ -f /etc/bash_completion ] && ! shopt -oq \ 


posix; then 


. /etc/bash_completion 


Check /etc/shadow for the following: 


root: *:15629:0:99999:7::: 
daemon: *:15629:0:99999:7::: 


If you see an asterisk (*) after the 
first colon on the line for root, you 
should remove it. This will allow you 
to set the root password yourself on 
the first run. 

You have completed the process 
of building the root filesystem for 
your board. Next, let’s compress the 


entire root filesystem so you can 
deploy it easily to your MicroSD card 
later. Exit the chroot environment 
and do the following inside your 
root filesystem directory: 


# umount proc 
# rm ./usr/bin/qemu-arm-static 


# tar -zcvf /home/user/my-rootfs.tar.gz * 


Preparing the MicroSD Card 

| am using a 4GB MicroSD card for 
my board. | am sure that a 2GB 
MicroSD card would be sufficient to 
contain all your files, but it is nice 
to have some room for additional 
applications. You need to create two 
partitions on your empty MicroSD 
card. The first one is a VFAT partition 
of around 17MB for U-Boot and the 
kernel image. The rest will be used 
to store your root filesystem. 

Mount the MicroSD card. Take 
note of the device name your 
computer gives the MicroSD card. 
Some computers recognize the 
card as /dev/sdX, while others call 
it /dev/mmcblkX (for this example, 
| assuming that your card is 
recognized as /dev/sdb): 


# fdisk -u=sectors /dev/sdb 


Type “p” to list the partitions 
inside the card. If you have any 
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viper@moblinux: ~ 


viper@moblinux:~$ sudo fdisk /dev/sdb 
Command (m for help): p 


Disk /dev/sdb: 3965 MB, 3965190144 bytes 

122 heads, 62 sectors/track, 1023 cylinders, total 7744512 sectors 
Units = sectors of 1 * 512 = 512 bytes 

Sector size (logical/physical): 512 bytes / 512 bytes 

I/O size (minimum/optimal): 512 bytes / 512 bytes 

Disk identifier: 0x000b7165 


Device Boot Start End Blocks Id System 
2048 34815 16384 83 Linux 
34816 7744511 3854848 83 Linux 


Command (m for help): i 


Figure 7. List of Partitions on a 4GB MicroSD Card 


partitions at all listed, delete them values, which will fill the remainder 
by pressing “d”. Once the card is of the card. 

empty, create a new partition by Type “p” again to list the 

pressing “n”. Make this the first partitions. You should see something 
primary partition. fdisk is going like what is shown in Figure 7. 

to ask you for starting and ending Type “w” to write the changes 
sector numbers. Type “2048” and permanently onto the card. Now, 
“34815”, respectively. Repeat the create the two filesystem types on 
process for the second partition. the partitions: 


This time, just press Enter when 
asked for starting and ending sector # mkfs.vfat /dev/sdb1l 
numbers; fdisk will use the default # mkfs.ext3 /dev/sdb2 
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Don't forget to do the sync 
after every command you type 
for the MicroSD card. Sync ensures 
that the changes are flushed and 
keeps the card in the correct state. 
Next, mount the partitions. | am 
assuming the mountpoints are 
/media/card1 for /dev/sdb1 and 
/media/card2 for /dev/sdb2. First, 
populate the root filesystem and 
copy the kernel modules onto the 
first partition: 


# cd /media/card2 

# tar -xzvf /home/user/Al13System/my-rootfs.tar.gz 

# sync 

... [THIS WILL TAKE SOME TIME] 

# cp -a $KERNEL_DIR/out/1ib/modules/3.4.43+/ \ 
./1ib/modules/ . 


# sync 


Copy the ulmage file from your 
kernel directory (in arch/arm/boot) 
to the first partition, along with 
a file called script.bin. script.bin 
stores the system configuration 
settings necessary for Allwinner 
chips. If you want to edit these 
settings, convert this .bin file into a 
.fex file using a tool called bin2fex. 
You can edit the resulting file with 
any text editor. 

For the last step, you need to 
write U-Boot onto the card itself. 
Pay extra attention to what you 


type here, as you are not going 
to write to /dev/sdb1 or /dev/sdb2 
but to /dev/sdb: 


# cd /home/user/A13System/u-boot 

# dd if=spl/sunxi-spl.bin of=/dev/sdb bs=1024 \ 
seek=8 

# dd if=u-boot.bin of=/dev/sdb bs=1024 seek=32 


# sync 


Now your MicroSD card is ready 
to-use. 


First Run 

Plug in the card in the slot on 
the board. Also plug in the 
Wi-Fi USB Stick, a keyboard 
and the VGA monitor (use a 
USB hub if you have to). Plug 
in the power cord and wait for 
the login prompt. 

Log in with the root account. 
You shouldn’t need a password 
for the first run. After you get in, 
set a secure password for your 
root account and create another 
account for your daily use. Put 
this new user into the sudoers 
file. Check whether you have 
network connectivity. Test the 
board remotely by connecting to 
it via SSH. If you can do all that 
successfully, congratulations! You 
have a great minimalist PC/server 
at your disposal. 
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IF YOU ARE INTERESTED IN USING THIS 
BOARD WITH A GRAPHICAL USER INTER- 
FACE, 

BECAUSE THE BOARD 

DOES NOT HAVE MUCH RAM TO SPARE. 
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Figure 8. Al3Micro Running Fluxbox 
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Desktop Environment 

If you are interested in using this 
board with a graphical user interface, 
you need to use a lightweight GUI 
environment, because the board does 
not have much RAM to spare. There 
are several options from which to 
choose, such as LXDE and XFCE4; 
however, | use a different package 
here called Fluxbox. You also need to 


install a light graphical login manager. 


Using the package manager, install 
lightdm and fluxbox. Yes, it is really 
that easy. These commands will install 
the desktop environment, graphical 
login manager and their required 
servers and libraries: 


root@al3board:/# apt-get install lightdm fluxbox 


Resources 


Restart the board. When the board 
restarts, you will be greeted with 
your new login manager. Make sure 
you select Fluxbox from the session 
menu on Lightdm screen when you 
are logging In. Enjoy your new 
mini-personal computer/server!m 


Ronald Kurniawan is a software developer living in Brisbane, 
Australia. Ronald is interested in embedded systems, Linux, 
Java development and trying to come up with interesting 
and wacky ways to combine them. Ronald can be reached 

at rkurniawan @fluxodesign.net. 


RUT U OUR UOROOOOURORRORODRORUOROROORDORDOROUTORUOTOORORUOROD 
Send comments or feedback via 


http://www.linuxjournal.com/contact 
or to ljeditor@linuxjournal.com. 


Debian Repositories List: http://www.debian.org/mirror/list 


A13Micro’s Kernel Configuration File: http://goo.gl/YnZ1s 


Script.bin for A13 and A13Micro Boards: http://goo.gl/7QZuo0U 


Ubuntu 12.04 Core Root Filesystem: http://goo.gl/eoALA 


Ubuntu 12.10 Core Root Filesystem: http://goo.gl/iLcV8 


Ubuntu 13.04 Core Root Filesystem: http://goo.gl/cytEY 


Qemu Source Code Download: https://launchpad.net/qemu-linaro/+download 
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HANDY 
U-BOOT 
TRICK 


Deploy and test new builds quickly with no more 
than rebooting the board. 


BHARATH BHUSHAN LOHRAY 
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mbedded developers working 
on kernels or bare-metal 
programs often go through 


several development cycles. Each 
time the developer modifies the 
code, the code has to be compiled, 
the ELF (Executable and Linkable 
Format)/kernel image has to be 
copied onto the SD card, and the 
card then has to be transferred from 
the PC to the development board 
and rebooted. In my experience as 
a developer, | found the last two 
steps to be a major bottleneck. Even 
copying files to the fastest SD cards 
is slower than copying files between 
hard drives and sometimes between 
computers across the network. 
Moreover, by frequently inserting 
and removing the SD card from the 
slot, one incurs the risk of damaging 
the fragile connectors on the 
development boards. Believe me! | 
lost a BeagleBoard by accidentally 
applying too much force while holding 
the board and pulling out the SD card. 
The pressure caused the I?C bus to 
fail. Because the power management 
chip was controlled by I?C, nothing 
other than the serial terminal worked 
after that. Setting aside the cost of 
the board, a board failure at a critical 
time during a project is catastrophic if 
you do not have a backup board. 


After losing the BeagleBoard, | hit 
upon the idea to load my bare-metal 
code over the LAN via bootp and 
TFTP and leave the board untouched. 
This not only reduced the risk of 
mechanically damaging my board, but 
it also improved on my turn-around 
times. | no longer needed to copy files 
to the SD card and move it around. 

In this article, | present a brief 
introduction to U-Boot and then 
describe the necessary configurations 
to set up a development environment 
using DHCP and TFTP. The setup 
| present here will let you deploy 
and test new builds quickly with 
no more than rebooting the board. 
| use the BeagleBone Black 
(http://beagleboard.org/Products/ 
BeagleBone%20Black) as the 
target platform and Ubuntu as 
the development platform for my 
examples in this article. You may, 
however, use the methods presented 
here to work with any board that 
uses U-Boot or Barebox as its 
Stage-2 bootloader. 


U-Boot 

U-Boot is a popular bootloader used 
by many development platforms. 

It supports multiple architectures 
including ARM, MIPS, AVR32, Nios, 
Microblaze, 68K and x86. U-Boot 
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U-Boot is a pretty advanced bootloader that is 
capable of loading the kernel and ramdisk image 
from the NAND, SD card, USB drive and even the 

Ethernet via bootp, DHCP and TFTP. 


Listing 1. The Serial Console Output from the Stage-1 Bootloader 


U-Boot SPL 2013.04-rc1-14237-g90639fe-dirty (Apr 13 2013 - 13:57:11) 
musb-hdrc: ConfigData=Oxde (UTMI-8, dyn FIFOs, HB-ISO Rx, 
™HB-ISO Tx, SoftConn) 

musb-hdrc: MHDRC RTL version 2.0 

musb-hdrc: setup fifo_mode 4 

musb-hdrc: 28/31 max ep, 16384/16384 memory 

USB Peripheral mode controller at 47401000 using PIO, IRQ 0 
musb-hdrc: ConfigData=Oxde (UTMI-8, dyn FIFOs, HB-ISO Rx, 
™HB-ISO Tx, SoftConn) 

musb-hdrc: MHDRC RTL version 2.0 

musb-hdrc: setup fifo_mode 4 

musb-hdrc: 28/31 max ep, 16384/16384 memory 

USB Host mode controller at 47401800 using PIO, IRQ 0 

OMAP SD/MMC: 0 

mmc_send_cmd : timeout: No status update 

reading u-boot. img 


reading u-boot. img 


has support for several filesystems The U-Boot project also includes 
as well, including FAT32, ext2, ext3, the x-loader. The x-loader is a small 
ext4 and Cramfs built in to it. It also = stage-1 bootloader for ARM. Most 


has a shell where it interactively modern chips have the ability to read 
can take input from users, and it a FAT32 filesystem built in to the 
supports scripting. It is distributed ROM. The x-loader loads the U-Boot 
under the GPLv2 license. U-Boot is a into memory and transfers control 
Stage-2 bootloader. to it. U-Boot is a pretty advanced 
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ROM 


——— 


X-Loader 
(MLO) 


Y 


Load U-Boot 
(uboot.bin) 
Wait for user interruption 


U-Boot Shell Execute bootcmd 


Load Kernel / ELF 


Figure 1. Boot Sequence 


bootloader that is capable of loading Figure 1 shows the default boot 

the kernel and ramdisk image from sequence of the BeagleBone Black. 
the NAND, SD card, USB drive and This sequence is more or less 

even the Ethernet via bootp, DHCP applicable to most embedded systems. 
and TFTP. The x-loader and U-Boot executables 
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Listing 2. The Serial Console Output from the Stage-2 Bootloader 
U-Boot 2013.04-rc1-14237-g90639fe-dirty (Apr 13 2013 - 13:57:11) 


IPE S ready 

DRAM: 512 MiB 

WARNING: Caches not enabled 

NAND: No NAND device found!!! 

Q@ MiB 

KG 3 OMAP SD/MMC: ©, OMAP SD/MMC: 1 


*** Warning - readenv() failed, using default environment 


musb-hdrc: ConfigData=Oxde (UTMI-8, dyn FIFOs, HB-ISO Rx, 
™HB-ISO Tx, SoftConn) 

musb-hdrc: MHDRC RTL version 2.0 

musb-hdrc: setup fifo_mode 4 

musb-hdrc: 28/31 max ep, 16384/16384 memory 

USB Peripheral mode controller at 47401000 using PIO, IRQ 0 
musb-hdrc: ConfigData=Oxde (UTMI-8, dyn FIFOs, HB-ISO Rx, 
HB-ISO Tx, SoftConn) 

musb-hdrc: MHDRC RTL version 2.0 

musb-hdrc: setup fifo_mode 4 

musb-hdrc: 28/31 max ep, 16384/16384 memory 

USB Host mode controller at 47401800 using PIO, IRQ 0 
Net: <ethaddr> not set. Validating first E-fuse MAC 
cpsw, usb ether 


Hit any key to stop autoboot: 0 


are stored in the files called MLO and shown in Listings 1-3. The x-loader 
uboot.img, respectively. These files are is responsible for the output shown 
stored in a FAT32 partition. The serial in Listing 1. Once the execution is 

port outputs of the BeagleBone are handed over to U-Boot, it offers you 
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Listing 3. The Serial Console Output from the Stage-2 Bootloader and Kernel 


gpio: pin 53 (gpio 53) value is 1 


Card did not respond to voltage select! 


gpio: pin 54 (gpio 54) value is 1 

SD/MMC found on device 1 

reading uEnv.txt 

58 bytes read in 4 ms (13.7 KiB/s) 

Loaded environment from uEnv.txt 

Importing environment from mmc ... 

Running uenvcmd ... 

Booting the bone from emmc... 

gpio: pin 55 (gpio 55) value is 1 

4215264 bytes read in 778 ms (5.2 MiB/s) 

gpio: pin 56 (gpio 56) value is 1 

22780 bytes read in 40 ms (555.7 KiB/s) 

Booting from mmc ... 

## Booting kernel from Legacy Image at 80007fcO ... 
Image Name: Angstrom/3.8.6/beaglebone 
Image Type: ARM Linux Kernel Image (uncompressed) 
Data Size: 4215200 Bytes = 4 MiB 
Load Address: 80008000 
Entry Point: 80008000 
Verifying Checksum ... OK 


## Flattened Device Tree blob at 80f80000 


a few seconds to interrupt the boot 
sequence, as shown in Listing 2. If 
you choose not to interrupt, U-Boot 
executes an environment variable 


Booting using the fdt blob at 0x80f80000 
XIP Kernel Image ... OK 
OK 


Using Device Tree in place at 80f80000, end 80f888fb 
Starting kernel ... 
Uncompressing Linux... done, booting the kernel. 


[ 0.106033] pinctrl-single 44e10800.pinmux: prop pinctrl-0 


index 0 invalid phandle 


[ 9.638448] net ethO: phy 4a101000.mdio:01 not found on slave 1 


The Angstrom Distribution beaglebone tty00 
Angstrom v2012.12 - Kernel 3.8.6 


beaglebone login: 


called bootcmd. bootcmd holds the 
search sequence for a file called 
uImage. This is the kernel image. 
The kernel image is loaded into the 
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Listing 4. Well Formatted Content of the Variable bootcmd 


@1 gpio set 53; 

02 i2c mw 0x24 1 Ox3e; 
03 run findfdt; 

04 mmc dev 0; 


05 if mmc rescan 


06 then 

07 echo micro SD card found; 

08 setenv mmcdev 0; 

OSmeilise 

10 echo No micro SD card found, setting mmcdev to 1; 
ial setenv mmcdev 1; 

2 il 


13 setenv bootpart ${mmcdev}:2; 
14 mmc dev ${mmcdev}; 


15 if mmc rescan; 


16 then 

iN7/ gpio set 54; 

18 echo SD/MMC found on device ${mmcdev}; 
i) if run loadbootenv; 

20 then 

Pal echo Loaded environment from ${bootenv}; 
ay run importbootenv; 
23 file 

24 if test -n $uenvcmd; 

25 then 

26 echo Running uenvcmd 
2H run uenvcmd; 

28 file 

29) gpio set 55; 

30 if run loaduimage; 

31 then 

Be. gpio set 56; 

33 run loadfdt; 

34 run mmcboot; 

35 fi 

36 fi; 
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memory, and the execution finally is 
transferred to the kernel, as shown 
in Listing 3. 

The search sequence defined in the 
bootcmd variable and the filename 
(ulmage) are hard-coded in the U-Boot 
source code (see Listing 9). Listing 
4 shows the formatted content of 
the environment variable bootcmd. 
The interesting parts of bootcmd are 


U-Boot shell. At the shell, you can 
see a list of supported commands 

by typing help or ?. You can list all 
defined environment variables with 
the env print command. These 
environment variables are a powerful 
tool for scripting. To resume the boot 
sequence, you either can issue the 
boot command or run bootcmd. A 
good way to understand what the 


The uEnv.txt file is a method for users to insert 
scripts into the environment. 


lines 19-28. This part of the script 
checks for the existence of a file 
called uEnv.txt. If the file is found, 
the file is loaded into the memory 
(line 19). Then, it is imported to the 
environment ready to be read or 
executed (line 22). After this, the 
script checks to see if the variable 
uenvcmd is defined (line 24). If it is 
defined, the script in the variable is 
executed. The uEnv.txt file is a method 
for users to insert scripts into the 
environment. Here, we'll use this to 
override the default search sequence 
and load the kernel image or an ELF 
file from the TFTP server. 

For better insight into the workings 
of U-Boot, | recommend interrupting 
the execution and dropping to the 


bootcmd is doing is to execute each 
command one at a time from the 
U-Boot shell and see its effect. You may 
replace the if...then...else...fi 
blocks by executing the conditional 
statement without the if part and 
checking Its output by typing echo $?. 


DHCP 

The DHCP (Dynamic Host 
Configuration Protocol) is a protocol 
to provide hosts with the necessary 
information to access the network on 
demand. This includes the IP address 
for the host, the DNS servers, the 
gateway server, the time servers, the 
TFTP server and so on. The DHCP 
server also can provide the name 

of the file containing the kernel 
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image that the host must get from 
the TFTP server to continue booting. 
The DHCP server can be set up to 
provide a configuration either for the 
entire network or on a per-host basis. 
Configuring the filename (Listing 5) 
for the entire network is not a good 
idea, as one kernel image or ELF file 
will execute only on the architecture 
for which it was built. For instance, 
the vmlinuz image built for an x86_64 
will not work on a system with an 
ARM-based processor. 

The Ubuntu apt repository 
offers two DHCP servers: 
isc-dhcp-server and dhcpcd. 
| prefer to use isc-dhcp-server. 

The isc-dhcpd-server from 
the Ubuntu repository Is pretty 
advanced and implements all the 
necessary features. | recommend using 
Webmin to configure it. Webmin 
is a Web-based configuration tool 
that supports configuring several 
Linux-based services and demons. | 


IMPORTANT NOTE: 


Be extremely careful while using the DHCP server. A network must not 
have more than a single DHCP server. A second DHCP server will cause 


Listing 5. The Host Configuration Section for 

a DHCP Server 

subnet 192.168.0.0 netmask 255.255.0.0 { 
next-server 192.168.146.1; 
option domain-name-servers 192.168.146.1; 
option routers 192.168.146.1; 


range 192.168.145.1 192.168.145.254; 


# The BeagleBone Black 1 
host BBB-1 { 
next-server 192.168.146.1; 
filename "/BI/uImage" ; 
hardware ethernet C8:A0:30:B0:88:EB; 


fixed-address 192.168.146.4; 


recommend installing Webmin from 
the apt repository. See the Webmin 
documentation for instructions for 
adding the Webmin apt repository to 
Ubuntu (http://www.webmin.com/ 
deb.html). 

Once you have your DHCP server 


serious problems on the network. Other users will lose network access. 
If you are on a corporate or a university network, you will generate a 
high-priority incident inviting the IT department to come looking for you. 


98 / OCTOBER 2013 / WWW.LINUXJOURNAL.COM 


installed, you need to configure 

a subnet and select a pool of IP 
addresses to be dished out to hosts 
on the network on request. After 
this, add the lines corresponding to 
the host from Listing 5 into your 
/etc/dhcp/dhcpcd.conf file, or do 
the equivalent from Webmin’s 
intuitive interface. In Listing 5, 
C8:A0:30:B0:88:EB corresponds to 
the BeagleBone’s Ethernet address. 
The next-server is the address of 
the TFTP server from which to fetch 
the kernel image of ELF. The /BI/ 
uImage filename is the name of the 
kernel image. Rename the image to 
whatever you use. 


TFTP 

TFTP (Trivial File Transfer Protocol) is 

a lightweight file-transfer protocol. 

It does not support authentication 
methods. Anyone can connect and 
download any file by name from the 
server or upload any file to the server. 
You can, however, protect your server 
to some extent by setting firewall 
rules to deny IP addresses out of a 
particular range. You also can make 
the TFTP home directory read-only 

to the world. This should prevent 

any malicious uploads to the server. 
The Ubuntu apt repository has two 
different TFTP servers: atftp and 


tftp-hpa. | recommend tftp-hpa, 
as development of atftp has seized 
since 2004. 

tftpd-hpa is more or less ready 
to run just after installation. The 
default file store is usually /var/lib/ 
tftpboot/, and the configuration files 
for tftp-can may be found in /etc/ 
default/tftpd-hpa. You can change 
the location of the default file store 
to any other location of your choice 
by changing the TFTP_DIRECTORY 
option. The TFTP installation creates a 
user and a group called tftp. The tftp 
server runs as this user. | recommend 
adding yourself to the tftp group and 
changing permissions on the tftp data 
directory to 775. This will let you read 
and write to the tftp data directory 
without switching to root each time. 
Moreover, if files in the tftp data 
directory are owned by root, the tftp 
server will not be able to read and 
serve them over the network. You 
can test your server by placing a file 
there and attempting to get It using 
the tftp client: 


$ tftp 192.168.146.1 -c get uImage [COMMAND] 
Some common problems you may 

face include errors due to permission. 

Make sure that the files are readable 


by the tftp user or whichever user the 
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Listing 6. An Example of the uenvcmd Variable for DHCP Booting 


echo Booting the BeagleBone Black from LAN (DHCP)... 


dhcp ${kloadaddr} 
tftpboot ${fdtaddr} /BI/${fdtfile} 


setenv bootargs console=${console} ${optargs} root=${mmcroot} 


=rootfstype=${mmcrootfstype} optargs=quiet 


bootm ${kloadaddr} - ${fdtaddr} 


Listing 7. An Example of uenvcmd Variable for TFTP Booting 


echo Booting the BeagleBone Black from LAN (TFTP)... 


env set ipaddr 192.168.146.10 
env set serverip 192.168.146.1 
tftpboot ${kloadaddr} /BI/${bootfile} 


tftpboot ${fdtaddr} /BI/${fdtfile} 


setenv bootargs console=${console} ${optargs} root=${mmcroot} 


=rootfstype=${mmcrootfstype} optargs=quiet 


bootm ${kloadaddr} - ${fdtaddr} 


tftpd runs as. Additionally, directories 
must have execute permission, or tftp 
will not be able to descend and read 
the content of that directory, and 
you'll see a “Permission denied” error 
when you attempt to get the file. 


U-Boot Scripting 

Now that you have your DHCP and 
TFTP servers working, let’s write 

a U-Boot script that will fetch the 
kernel image and boot it. I’m going 
to present two ways of doing this: 
using DHCP and using only TFTP. As | 
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mentioned before, running a poorly 
configured DHCP server will cause a 
network-wide disruption of services. 
However, if you know what you are 
doing and have prior experience with 
setting up network services, this is the 
simplest way to boot the board. 

A DHCP boot can be initiated 
simply by adding or modifying the 
uenvcmd variable in the uEnv.txt file, 
as shown in Listing 6. uEnv.txt is 
found in the FAT32 partition of the 
BeagleBone Black. This partition is 
available to be mounted when the 


BeagleBone Black is connected to 
your computer via USB cable. 

For a TFTP-only boot, you manually 
specify an IP address for the 
development board and the TFTP server. 
This is a much safer process, and you 
incur very little risk of interfering with 
other users on the network. As in the 
case of configuring to boot with DHCP, 
you must modify the uenvcmd variable 
in the uEnv.txt file. The script shown in 
Listing 7 is an example of how to set up 
your BeagleBone Black to get a kernel 
image from the TFTP server and pass on 
the execution to It. 

Both Listing 6 and 7 are formatted 
to give a clear understanding of the 
process. The actual uEnv.txt file should 
look something like the script shown 
in Listing 8. For more information 
about U-Boot scripting, refer to the 
U-Boot FAQ (http://www.denx.de/ 
wiki/DULG/Faq) and U-Boot Manual 


Listing 8. An Example of uEnv.txt for TFTP Booting 


optargs=quiet 


uenvcmdx=echo Booting the bone from emmc...; 


(http://www.denx.de/wiki/DULG/ 
Manual). The various commands in 
the uenvcmd variable must be on the 
same line separated by a semicolon. 
You may notice that | place my script 
in uenvcmdx instead of uenvcmd. 


This is because test -n throws an 
error to the console based on the 
content of the variable it is testing. 
Certain variable contents, especially 
long complicated scripts, cause the 
test -n to fail with an error message 
to the console. Therefore, | put a 
simple command to run uenvcmdx 
in uenvcmd. If you find that your 
script from the uEnv.txt is not being 
executed, look for an error on the 
serial console like this: 


test - minimal test Like /bin/sh 


Usage: 
test [args..] 


env set ipaddr 


™192.168.146.10; env set serverip 192.168.146.1; tftpboot 


=»${kloadaddr} /BI/${bootfile}; tftpboot ${fdtaddr} 


=/BI/${fdtfile}; setenv bootargs console=${console} 


=»${optargs} root=${mmcroot} rootfstype=${mmcrootfstype} 


moptargs=quiet; bootm ${kloadaddr} - 


uenvcmd=run uenvcmdx 


${fdtaddr} 
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On some development 
boards like the BeagleBoard xM 
(http://beagleboard.org/Products/ 
BeagleBoard-xM), the Ethernet 
port is implemented on the USB bus. 
Therefore, it is necessary to start the 
USB subsystem before attempting 
any network-based boot. If your 
development board does not hold a 
Flash memory on board, it may not 
have a MAC address either. In this 
case, you will have to set a MAC 
address before you can issue any 
network requests. You can do that 
by setting the environment variable 


ethaddr along with the rest of the 
uEnv.txt script. 

An alternative but cumbersome 
way to change the default boot 
sequence is to modify the U-Boot 
source code. Modifying the source 
code gives you greater versatility for 
booting your development board. 
When you interrupt the U-Boot boot 
sequence, drop to the U-Boot shell 
and issue the env print command, 
you'll see a lot of environment 
variables that are defined by default. 
These environment variables are 
defined as macros in the source 


Listing 9. Part of the u-Boot/include/configs/am335x_evm.h File Responsible for the Default 


Script in the bootcmd Variable 


#define CONFIG _BOOTCOMMAND \ 


"mmc dev ${mmcdev}; if mmc rescan; then " \ 
"echo SD/MMC found on device ${mmcdev};" \ 
“Tt Un loacloooremvys chem ” \ 

"echo Loaded environment from ${bootenv} 


"run importbootenv;" \ 


mig 

"if test -n $uenvcmd; then " \ 
"echo Running uenvcmd ...;" \ 
"run uenvemd;" \ 

atl aaN 

"if run loaduimage; then " \ 


"run mmcboot;" \ 


A fleas \ 
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code. Modifying the source code 
aims at modifying these variables. 
As shown in Figure 1, U-Boot begins 
loading the kernel by executing the 
script In bootcmd. Hence, this is the 
variable that must be modified. 

To begin, you'll need the source code 
to U-Boot from the git repository: 


$ git clone git://git.denx.de/u-boot.git 


Before making any modifications, | 
recommend compiling the unmodified 
source code as a sanity check: 


$ make ARCH=arm CROSS COMPILE=arm-1linux-gnueabihf- distclean 
$ make ARCH=arm CROSS _COMPILE=arm-1linux-gnueabihf- am335x_evm_config 
$ make -j 8 ARCH=arm CROSS COMPILE=arm-1inux-gnueabihf- 


This most likely will work without 
a hitch. Now you can modify the 
u-Boot/include/configs/am335x_evm.h 
file. In this file, you'll find code similar 
to Listing 9. Modify this as you please 
and re-compile. Depending on your 
target board, you will have to modify 
a different file. The files to some 
common target platforms are: 


m™ Panda Board 
(http://pandaboard.org): u-Boot/ 
include/configs/omap4_common.h 


™ BeagleBoard: u-Boot/include/ 
configs/omap3_beagle.h 


Conclusion 

| hope the instructions provided here 
help you create a system to develop 
and deploy bare-metal programs 
and kernel images quickly. You 

also may want to look into 
u-boot-v2, also known as Barebox 
(http://barebox.org). The most 
helpful code modification that 

| suggest here is to compile the 
U-Boot with an elaborate boot 
sequence that you can tailor to your 
needs with the least modifications. 
You can try out some fancy scripts 
to check and update firmware 

over LAN—! would consider that 
really cool. Write to me at bharath 
(you-know-what) lohray (you-know- 
what) com.m 


Bharath Bhushan Lohray is a PhD student working on 

his dissertation on image compression techniques at the 
Department of Electrical and Computer Engineering, Texas 
Tech University. He is interested in machine learning and 
considers building a terminator the echelon of human 
advancement—at least until we build the terminator. 


Tee 
Send comments or feedback via 
http://www.linuxjournal.com/contact 
or to ljeditor@linuxjournal.com. 
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Cloud 


The Personal 


The Personal Cloud gives you access and control over your 
own data and lets you do more with it than your vendors 
can. Who wouldn’t want that? The question is, how do we 


get there from here? 7.ROB 


Personal. 

What do you say when someone 
asks “How much money do you 
make?”, or “How old are you?”, 
or “How much do you weigh?”, 
or “What is your address?” The 
quintessential response “that’s 
personal” works because of an 
underlying assumption that we are 
within our rights to withhold that 
information and, more important, that 
privacy is the default and natural state 
of affairs. There is no government 
procedure on reaching the age of 
majority requiring you to check 
boxes on an interminably long list, 
enumerating all of the personal data 
attributes that you choose to keep 
private. As a sovereign person, they 
are all considered private. It is your 
choice whether to reveal your income, 
age, weight or any other piece of 
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personal information. The ubiquity of 
the phrase “that’s personal” speaks to 
a broadly shared understanding that 
we get to choose what information 
about ourselves we reveal and to 
whom we reveal it. 

Cloud. 

There is no industry-standard 
definition of the term “cloud”, but we 
should at least all be able to agree on 
a few attributes. Many of these are 
optional depending on who you talk 
to, but the one essential element of 
the cloud is abstraction. An observer 
sees the cloud as a single logical thing 
with which to interact and need not 
be concerned with the individual 
elements that make up the cloud. 

In addition, a cloud will have one or 
more of the following elements: 


M Elasticity: computing resources can 
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be allocated dynamically to match you? How much do you weigh? What 
variable load. is your address?” Whether the cloud 
is personal or not depends on who 
m Redundancy: the use of multiple gets to decide the answers to these 
physical servers increases the questions. It is not enough that the 
availability of the cloud service. response back Is “that’s personal” 
if someone else can override your 
M Resiliency: the cloud service can preferences and make the disclosure 
survive interruption or loss of some —_ anyway. It is only a Personal Cloud 
physical components without loss if you have ultimate control over 
of function. whether to disclose that information. 
A Personal Cloud starts with the 
mM Runtime resolution: resource assumption that privacy is the default 
identities and addresses are and natural state of affairs and then 
resolved dynamically. incorporates that design philosophy 
into a cloud computing architecture 
m Ubiquity: some clouds are public owned and operated by an individual. 
while others are private. However Resist the temptation to read more 
they are scoped, a cloud service Is into that statement than there Is. 
expected to be accessible from all For example, there is no requirement 
points within that scope. that a Personal Cloud must be self- 
hosted. Today there are commercial 
By incorporating these elements, services for password management, 
cloud architecture aims to deliver storage, backups, VoIP, chat and 
computing services that are as reliable = more, all of which fit the definition 
and available as power or water. The of Personal Cloud. In all these cases, 
ultimate expression of the cloud is the custodians of the data have no 
that the computing infrastructure access to It. Instead, they provide 
completely disappears except for the the framework in which the data 
user interface. owner sets policies that express the 
Personal Cloud. relationship between the data and any 
Imagine a cloud database filled with third parties authorized to access it. If 
information about you and a vendor it is a cloud architecture, respects the 
inquiring of that cloud “How much owner's privacy, and the owner Is the 
money do you make? How old are ultimate authority over authorization 
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decisions, it is a Personal Cloud. 


Not a Buzzword 
Much of the buzz about cloud 
computing is just that—buzz. But 
Personal Cloud is more. There is 
a parallel here with the way we 
purchase motive power. In San 
Francisco, halfway down the hill on 
Mason Street, there are giant motors 
transferring motive power to cables, 
which in turn run below the street to 
distribute that motive power along 
the cable car routes. When the cable 
car requires motive power, it gets It 
directly from the cable. Many years 
ago, factories worked the same way. 
Large motors distributed motive 
power to belts and pulleys that 
distributed it throughout the factory. 
But that method didn’t scale very 
well. There is no tap from your house 
to an underground cable that provides 
power for washers and dryers, 
refrigerators and so on. Nor is there 
a giant motor in the back yard and a 
system of pulleys and belts running 
from it to the house. Instead, we 
self-host hundreds of tiny motors, 
invisibly built in to disk drives, DVD 
players, appliances, clocks and almost 
everything capable of movement. 
The magic of this is that we don't 
think of these things as motors that 
wash clothes, tell time or spin digital 
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media. The motors have receded into 
the background, and we rarely think 
about them at all, unless they break. 

The same thing is happening 
now with computing. There is more 
computing capacity in the average 
modern phone than there was in the 
Lunar Lander. It's everywhere around 
you, and more is on the way. All of 
your devices that have an embedded 
motor soon will have embedded 
computing power, if they do not 
already. Things that currently have no 
motor or computing power—switches, 
outlets and bulbs, for example—soon 
will become smart. More important, 
all of these sensors, devices and 
computing platforms are increasingly 
interconnected and integrated with if- 
then-else rules engines that correlate 
events to generate complex behaviors 
in formerly dumb devices. Sensors, 
actuators and computing power are 
quietly but inexorably being woven 
into the fabric of your life. 

Is it reasonable to assume that with 
all this computing power available 
to individuals that we will fail to 
apply it in commercial settings for 
our own benefit, in much the same 
way that our vendors have applied 
it on the supply side? The value 
proposition of E-Commerce, Supply 
Chain Management and Customer 
Relationship Management always 


applied to individual users. We never 
delivered it to that market because of 
cost, but that barrier continues to fall. 
These applications radically transformed 
commerce on a global scale when they 
were first built out by large enterprises. 
We have the opportunity to transform 
commerce again, with even greater 
impact, by building out business 
functionality on the consumer side. 
Or we could continue to focus on 
making better versions of Angry Birds 
and moving light switches from the 
wall to the phone. 

Today’s architecture, in which 
vendors have all the data and 
computing power, is a dying relic, left 
over from a world where computing 
was specialized and so expensive that 
only large businesses could afford it. 

It is the cable car wheelhouse or the 
big motor out back behind the factory. 
But in a world of cheap and abundant 
computing power, individuals are the 
natural points of integration for their 
own data. Now we have the choice 

to continue on with the legacy model 
or to move to a new model in which 
the individual’s computing capacity 
improves the experience of both the 
individual and the vendor. Having 

all that computing power on the 
consumer side and not building out 
new business integration seems to me 
to be akin to ripping the motors out of 


all the disk drives, DVD players, clocks, 
refrigerators and other appliances, and 
equipping them with belts and pulleys. 
You could do it, but it doesn’t scale 
and you won't like the experience. 


Impersonal Clouds 
Let’s revisit that cloud database filled 
with information about you and a 
vendor inquiring of that cloud “How 
much money do you make? How old 
are you? What is your address?” If 
that cloud is owned by a credit bureau 
or data broker, the responses will be 
the actual values. There is no default 
assumption of privacy. You have no 
say in how much data about you these 
commercial entities hold, whether it 
is accurate or with whom they share 
it. The entire business model of data 
brokers is to provide answers for 
questions to which, if you had been 
asked in person, you would have 
responded by saying “that’s personal”. 
The impersonal cloud also hoards 
your data, preventing you from 
deriving any benefit from it. If you 
participate in a grocery loyalty 
program, somewhere out there is 
a database containing line-item 
records all your purchases. That's a 
rather intimate level of detail about 
you and your immediate household. 
If someone on the street asked you 
detailed questions about some of 
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those line items, you undoubtedly 
would say “that’s personal”. If that 
same person then offered to pay you 
a dollar for details of which personal 
hygiene products you use and how 
often you buy them, it would seem 
creepy. But that is exactly the kind of 
information we give out in exchange 
for a dollar off of a jug of milk. 

I've been told that the average 
person has no use for grocery line- 
item data. If that is true (and | don’t 
believe that it is), it’s only because 
we do not yet have access to that 
data and, therefore, have not written 
applications to use it. We don’t know 
now what we'll do with that data any 
more than we could have looked at 
HTTP in 1983 and predicted Web 2.0. 
What we do know now though is that 
all the data is held by vendors, and 
wherever it is that Personal Cloud can 
take us, we can’t get there from here. 
Getting access to our own data is the 


first step. Personal Cloud is Cloud 2.0. 


Strategies for Personal Cloud 
Development 

Twenty years from now, we will know 
what the Personal Cloud equivalents 
of Google, Wikipedia, YouTube, 
Facebook and Instagram are, and 
they will seem obvious in hindsight. 
But if you want to get started in 
Personal Cloud today, where do 
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you place your bets? Although the 
specific implementations have yet to 
be revealed—that’'s your job—we do 
know some general directions with a 
high degree of confidence. First and 
foremost among these is that the 
Personal Cloud wants to be invisible. 
Once the user sets up the connection 
and preferences, the fact that the 
apps are backed by a Personal Cloud 
should not normally be evident to 
the user. The exceptions exist mainly 
where the Personal Cloud provides 
enhanced functionality, such as 
prompting the user for permission to 
release information. Other than those 
exceptions, all the user should see is 
the exposed functionality. 

Some additional Personal Cloud 
directions are listed below. The 
strategy for deriving these is to 
imagine a future state where privacy 
is baked into the architecture and 
where sharing is enabled by policy. 
This is the opposite of today’s model 
where the architecture is built for 
Sharing and privacy is provided by 
policy. Also, assume a future state 
where individuals have access to all 
the transaction data their vendors 
currently collect, and to the data from 
all their devices, and that all of this 
is accessible to the user in aggregate 
through their Personal Cloud. 

Software — Extend Supply Chain 


management systems all the way to 
the consumer so that the merchant is 
the next-to-last rather than the last 
stop in the chain. The opportunity 
here is to create the API of Me and My 
Things and to assist large Enterprise 
to understand the value in integrating 
with it. Considerable momentum 
already exists in Vendor Relationship 
Management applications, the 
consumer counterpart to Customer 
Relationship Management. In short, re- 
imagine business software as owned 
and operated by and for the individual. 
There are a number of initiatives 
and groups working to provide 
infrastructure and resources to further 
these concepts. The unsurprisingly 
named Privacy By Design framework 
“advances the view that the future 
of privacy cannot be assured solely 
by compliance with legislation and 
regulatory frameworks; rather, 
privacy assurance must become 
an organization’s default mode 
of operation”. The Personal Data 
Ecosystem Consortium’s mission is to 
connect entrepreneurs and startups 
focused on user-centric personal data, 
advocate for individuals’ rights to tools 
and access to their own data, and to 
help existing businesses dependent 
on the old personal data ecosystem 
transform to become profitable in 
the new one. The Respect Network 


extends the basic connectivity of the 
Internet with a community and context 
for trusted identity and interactions 
between people, businesses and 
devices. There is a growing collection 
of information, references and index 
of projects related specifically to 
Personal Cloud at Personal-Clouds.org. 
The folks at Kynetx have built and 
implemented CloudOS and an event 
network that are up and running 
today and built on the Personal Cloud 
philosophy. This is a non-inclusive list 
but will jump-start your investigation 
into Personal Clouds. 

Data aggregation and 
integration — Much of the value 
of data lies in the ability to correlate 
and analyze across many datasets 
to find valuable relationships. For 
example, consumers can participate 
in cradle-to-cradle tracking of 
recyclable resources by integrating 
data from their purchasing, waste 
and recycle streams. Add Health 
data to the mix for insight into how 
dietary purchasing habits affect 
wellness. Integrate power and water 
consumption for a total household 
greenness rating. But, which vendor 
will collect and manage all this 
information for you? 

Mint.com aggregates all your 
financial accounts into a single view 
but probably won't be adding your 
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health records, power and grocery 
loyalty information any time soon, 
nor would you want it to. If Mint.com 
began asking for your health and 
grocery data, you probably would 

tell it “that’s personal”. The Personal 
Cloud version of an aggregator 
operates more like FileThis.com. 
FileThis periodically fetches your 
bank statements, e-bills and 
purchase receipts, then loads them 
into a data store that you control. 

It never stores the information it 
collects on your behalf nor does it 
attempt to provide any analysis or 
presentation of that data. You supply 
the credentials and the storage, it 
supplies the integration. 

Apart from a few early examples, 
this field is wide open. Every loyalty 
program, interactive heath service, 
government-hosted citizen database, 
social-media service, utility provider, 
identity provider, bookmark sync 
service, contact list or other service 
that holds your information is a 
candidate either to aggregate that 
data into a single view or pull it into 
the individual’s Personal Cloud. If those 
services hope to remain competitive, 
they will recognize the value in 
empowering individuals to access their 
own data and begin to cooperate with 
integrators and publish APIs. 

Hosted apps and plugins — hosting 
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providers cannot process your data 
if they cannot see it. If you are to 
get any value out of the data you 
choose to keep private, you will 
need something that you control to 
correlate, analyze and visualize it. One 
approach, exemplified by OwnCloud, 
is a framework made up of database 
hosting, a plugin architecture and APIs. 
Out of the box, the system supplies 
cloud storage, calendaring, contact 
lists, music streaming and on-line 
photo galleries. But the real power Is 
in the plugin architecture and APIs. For 
example, there is no personal health 
vault in the basic version of OwnCloud, 
but that easily could be added. 
Alternatively, some Personal Cloud 
applications will run standalone. 
Consider the FileThis service 
mentioned previously. Among 
the other accounts to which it 
integrates, it can download your 
bank statements. But this requires 
you to give it your on-line banking 
credentials, which is a bit problematic. 
That issue would go away if you 
could run its application locally. The 
standalone app model provides all the 
benefits of the vendor's integration 
know-how without exposing your 
banking account credentials. 
Retro-fit — There are a lot of 
“dumb” appliances out there with 
plenty of useful life in them. Similarly, 


there are very few existing houses 
wired for data or that have their own 
Personal Cloud servers. If we imagine 
a future world where all those devices 
are smart, how do we get from here 
to there? One way might be to take 
the Crutchfield approach and apply it 
to the Internet of Things. 

Crutchfield built an unlikely 
business by betting that ordinary 
people could and would install high- 
end stereos into their own cars if they 
had access to tools and instructions. 
Crutchfield provided custom wiring 
harnesses that eliminated most of 
the complexity, access to tools and 
comprehensive instructions from an 
exhaustive database of vehicle makes 
and models. The bet paid off and it 
grew into a formidable player in the 
consumer audio business. 

A similar model would work for 
Internet-enabling dumb devices. 
Assuming that you had the 
appropriate wiring harness, a WI-Fi- 
enabled Arduino or Digispark could 
be dropped into a washer, dryer, 
refrigerator or other appliance in 
minutes. This could jump-start the 
Internet of Things and most of the 
research could be crowdsourced. 
There are business opportunities in 
performing the installations and in 
providing the code that sends and 
receives events from the devices 


and turns those into more complex 
behaviors. Of course, getting a data 
fabric into the home is a prerequisite, 
so the installation of home- 
automation servers, cabling, power- 
over-Ethernet and Wi-Fi access points 
also will be a growth opportunity. 


Stupid Cloud Tricks 

To seed your mind with ideas for 
Personal Cloud development, imagine 
a world in which the most mundane 
objects and surfaces are smart and in 
which you can program behaviors based 
on interactions of devices and events in 
your life. The cloud also has access to 
all your transaction and demographic 
data, location and preferences. Now 
combine these in the most far-fetched 
way that you can think of. 

Here’s an example. My smart house 
would have individually addressable 
path lighting throughout. My dog 
would have an NFC or Bluetooth 
beacon on his collar so that the 
house could know exactly where he 
is. | would then program a behavior 
causing the path lighting to follow 
him around the house. Once he got 
used to that, | would train him that 
following the path lighting cues 
would lead to a reward. The last step 
would be to create a phone app (I'll 
call it “Fetch”) that leads the dog 
from wherever he is in the house to 
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wherever | am. 

| admit this is a very stupid cloud 
trick. | criticized vendors for moving 
wall switches to phone apps, and | 
just did the same thing with the dog. 
The point is that if you own the data 
and your devices talk first to you 
instead of the vendor, you are not 
constrained by the vendor's choice of 
integrations and can invent weird and 
wonderful behaviors for your stuff. 
(But you have to admit that a phone 
app that remotely controls the dog is 
kinda cool.) So let’s try something a 
bit more practical. 

Your power company has a rate 
plan that lets it shut off your water 
heater and air conditioner when it 
or a neighboring utility has a peak 
load shortage. But why limit this to 
water heaters and air conditioners? 
When the home is filled with smart 
devices, it will be possible for 
lights, fans, battery chargers or 
any powered device to take part 
in discretionary load abatement. 
For example, on receiving an 
abatement request, an LED bulb (or 
the dashboard controlling that bulb) 
might respond with an offer to cut 
10% of its current drain during 
the abatement period. Because the 
house knows whether anyone Is 
home, the degree of abatement can 
vary automatically and accordingly. 
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You don’t have to honor the pledge 
and can turn the light back up, but 
the closer your house gets to its 
projected abatement, the larger the 
rebate you get. 

With enough devices 
participating, discretionary load 
abatement will allow us to defer the 
need to build more power plants. 
But this considers only the first- 
tier effects. The system really gets 
interesting when social aspects 
are added. Your Personal Cloud 
knows how much load abatement 
you have provided, what your 
baseline usage is and the normal 
interior conditions in the house. 
Someone eventually will combine 
these into a competitive social 
app where individuals or groups 
can compete for energy-efficiency 
badges. How do you compare 
with your neighborhood? Your 
region? Households with similar 
demographics? Can your scout 
troop be the greenest in the pack? 

What will your Stupid Cloud Tricks 
be? Feel free to dream some up and 
send them to ljeditor@linuxjournal.com. 
Or just wait a few years and create 
them for real. 


Personal Cloud = Opportunity 
These types of applications are not 
only possible but trivial when we 


all have access to our own data and 
are not dependent on vendors for 
the integrations. Personal Cloud 
detractors claim that individuals have 
shown no interest in having access 
to their own data. Until PRISM, many 
said we have no interest in privacy 
either. But this is not a question of 
whether Personal Clouds will exist 
or whether individuals need or want 
access to their own data. Technology 
seeps into every niche that will 
Support it, and this is hardly a niche. 
When the value of Personal Cloud 
apps exceeds their cost, they will 
flourish. It really is that simple. 

The market for Personal Clouds is 
a superset of that for mobile phones, 
game consoles, NAS devices, home- 
entertainment servers and home- 
automation servers because they 
are all potentially participants. That 
is a very large market, which with 
regard to Personal Cloud, is as yet 
untouched. Those who can make 
the value of Personal Cloud exceed 
the cost (as measured in currency, 
skill requirement and administrative 
overhead) can begin to carve out 
their own piece of that very large pie. 

Would you like your piece of that 
pie now? For more information on 
Personal Clouds and the ecosystem 
growing up around them, please 
visit the Personal Data Ecosystem 


Consortium, Project VRM and the 
Respect Network.@ 


TRob spent the last 20 years working on security, clustering, 
high availability and architecture of enterprise messaging. He 
intends to spend the next 20 applying these same technologies 
to benefit individuals through technologies, such as Personal 
Cloud and Internet of Things. He recently left IBM, where he 
was a product manager for the WebSphere messaging product 
family, to start loPT Consulting with the mission of putting 
People first in the Internet of Things. He can be found at 
https://ioptcponsulting.com or https://t-rob.net. (Full disclosure: 
TRob is a member of the Respect Network and the Personal Data 
Ecosystem Consortium, but please don’t hold that against them.) 


Resources 
FileThis: http://filethis.com 


Kynetx Developer Resources: 
http://developer.kynetx.com 


LastPass: https://lastpass.com 
Mint: http://www.mint.com 
OwnCloud: https://owncloud.com 
PDEC: http://pde.cc 


Personal Clouds.org: 
http://personal-clouds.org 


Privacy by Design: 
http://www.privacybydesign.ca 


Project VRM: http://projectvrm.org 


Respect Network: 
http://respectnetwork.com 
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The First 
Personal 


DOC SEARLS 


Platform —for 
Everything 


Computing started out corporate, then it got personal. 
Same thing happened with networking. Next up: the cloud. 


aybe the biggest thing that 
ever happened to Linux— 
at least scale-wise—is 


virtualization. As | recall, virtualization 
first materialized in a big commercial 
way with IBM, which started by putting 
many Linux instances on System z 
mainframes. (Once on the old Linux 
Show, we had a guest geek from IBM 
who said it was not only his idea, 

but also that he came up with it over 
lunch.) IBM didn’t call those mainframes 
“clouds”, but that’s what it hosted. 
Now we have clouds of clouds of Linux 
all over the place. Nothing could be 
more widespread and ordinary. (Of 
Netcraft’s ten most reliable hosting 
company sites for June of this year, 
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eight are Linux and two are FreeBSD: 
http://news.netcraft.com/archives/ 
2013/07/01/most-reliable-hosting- 
company-sites-in-june-2013-2.html.) 
Now think about the Internet 
of Things, often abbreviated loT. 
It is generally assumed today that 
the Internet of Things will require 
embedded smarts. But in fact, any thing 
can have a cloud, whether the thing 
has embedded smarts or not. This 
insight comes to us from Phil Windley 
(http://www.windley.com), the hacker- 
in-chief of Kynetx (http://kynetx.com), 
a small Utah start-up with very big plans. 
(Disclosure: | sometimes consult them, as 
| do a number of other companies.) Phil 
is also the inventor and alpha maintainer 


of CloudOS, a small and simple cloud 
operating system for anybody and 
anything, including you and every thing 
you own. CloudOS Is open source and 
GPL'd. So is KRL (kinetic rule language, 
http://en.wikipedia.org/wiki/Kinetic_ 
Rule_Language), the first language for 
programming on CloudOS (among other 
things), also first authored by Phil. 

By abstracting intelligence away from 
physical things, we can unburden those 
things of the need to be intelligent in 
themselves. In fact, we can enlarge to 
absolute the variety of things that can 
have intelligence. Phil embodies this range 
in the word “pico”, for persistent compute 
object. One of his is a pothole in front of 
his house (http://www.windley.com/ 
archives/2013/04/potholes_and_ 
picos.shtml). That pothole has brains 
in the cloud Phil gave to it, and that 
cloud Is in Phil’s personal cloud 
(http://personal-clouds.org/wiki/ 
Main_Page). To help demonstrate how 
this can work in everyday life, here is a 
list of things I’ve made smart by giving 
each its own cloud: 


M Canon 5D camera body. 

mM Canon 30D camera body. 

mM Dish Network VIP 922 set-top box, 
with Slingbox. 

M Eurorack UB802 audio mixer. 

mM LaCrosse Technology BC-9009 
battery charger. 


Sangean PR-D5 radio. 

Delkin Sensor Scope. 

Ful backpack. 

InFocus Model LP-130 projector. 

Teac model HD-100 HD Radio receiver. 
Sirius Sportster satellite radio receiver. 
Garmin Legend HCx GPS. 

A 30" x 30" tablecloth that looks 
like the QR code shown in Figure 1 
(https://squaretag.com/app.html#!/ 
app/a41x178/squareTag_scanned 
&tagName=YUV6WT &token= 
EOBFBEA6-E8CD-11E2-BD96- 
D358A022FB09). 


The doors to those things’ clouds 
are the QR codes I’ve hung or stuck on 
them—and, in the case of the last one, 
the item itself is a QR code. There can 
be other doors as well (for example, 
URLs), but QR codes are handy because: 
a) as with Ethernet, the patent owners 
(Denso, in Japan) decided they would 
rather create more value than they 
capture, so they let anybody do anything 
they want with QR codes; and b) they’re 
easy to scan with a smartphone. 


Figure 1. 
Doc’s 30" x 30° 
tablecloth 
looks like this 
QR code. 
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Until now, QR codes have had the 
misfortune of being exploited mostly 
by marketers, which is why they 
appear as “robot barf” on promotional 
jive all over the place. But now it’s time 
for the hackers to take over, which 
is what the ones working for Kynetx 
have done. They created a service 
(http:/Awww.windley.com/archives/ 
2013/01/introducing_squaretag.shtml) 
called SquareTag (https://squaretag.com), 
which hosts things’ clouds. SquareTag's 
business model, for now, is selling hang- 
tags and stickers with QR codes on them. 
I'm using some of the tags and stickers 
for the things in the list above. (Note 
that SquareTag isn't a silo. | can take my 
things’ clouds, plus my own personal 
cloud, and put them wherever | want. 
That means | can self-host them, put 
them in Dropbox, or stick them in some 
other cloud service.) 

Through a feature called “safe and 
mine” you can present a message to any 
Samaritan who scans the QR code of a 
thing you've lost. For example, “This bag 
belongs to (your name). Text me at (your 
number).” From any computing device, 
you can write or change that message. 

But here's the biggest thing: 

Every thing’s cloud is a platform for 
relationship—between you (as the 
owner) and whoever else you welcome 
aboard: notably the companies that 
make and sell the things you've bought. 
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For example, | have messages waiting 
for the makers of many of the items 
above. Here are a few: 


mM Canon — /'m in the market for a 5D 
Mark Ill when the price for a new one 
falls below $2500. 


m LaCrosse — /'/l be glad to testify 
my love for the charger in any 
promo you want to run. It’s the best 
charger I’ve ever used. The display 
also tends to flicker and fade. Is 
there an easy fix for that? 


mM Sangean — Gave the radio a 5-star 
review on Amazon, but | won’t 
buy another one like it unless it 
does HD too. 


B Garmin — Love the sensitivity and 
the Ul. What | want are more than 
10,000 waypoints in memory and the 
ability to produce KML files. 


mM Dish Network — DishAnywhere is 
a great system. That’s mostly how | 
watch the VIP 922. What I'd like is 
to have access to all the menu items 
remotely through the browser Ul and 
on the tablet app. Please notify me 
when that feature is ready. Thanks. 


| also can advertise to the world, 
should | wish, some or all of what | 


say about those products in my cloud. 


Or, | can restrict what | say just to the i 4 « s 

companies | invite into a relationship, Advertiser Index 

such as the ones above. Thank you as always for supporting our 
Likewise, any company (such as advertisers by buying their products! 

Canon, LaCrosse, Sangean and Garmin) 

can give every product it sells a unique ADVERTISER 


cloud of its own, with its own QR code, 
and transfer ownership of that cloud to 
the customer along with the product 


All Things Open ttp://www.allthingsopen.org 


AnDevCon Fall -/Awww.andevcon.com 


itself. If the customer welcomes a pyran | eyes ney 
relationship with the company, and the 

Drupal Camp Atlanta ttp:/Awww2.mediacurrent.com/ 
company agrees to the customer's terms OS eIER a Reo 
of engagement (such as, “respect the oe hisselaeaeetate 


privacy of this communication channel in 
the following ways”), the whole “own 
cycle” of a product becomes a much 
richer experience for both the customer Mania Enns Hfestnonsaeiae ea 
and the company. The QR code then ov ee 
becomes what's called a “TalkTag”— 
meaning that its purpose is to serve as 
a way for the customer to signal his or Silicon Mechanics _hitp/wwwsiiconmechanicscom 
her interest in talking to the company. 
For example, | can program the cloud of 
my Dish Network set-top box to make a 
scan of its QR code send a message to 
the company saying I'd like a call from 
an agent to help me work through a 


EmperorLinux -//www.emperorlinux.com 


iXsystems, Inc. /www.ixsystems.com 


Seattle GNU/Linux ‘//seagl.org 
Conference 


USENIX LISA s://www.usenix.org/conference/LISA2013 


problem. I've talked to call-center people Pheuliuxsourgal Brand’ s/{ellowingihas 
‘ a a . grown to a monthly readership nearly 
about this possibility and they love it. one million strong. Encompassing the 
What they love especially is that it’s magazine, Web site, newsletters and 
now possible to have a standard way much more, Linux Journal offers the 


ideal content environment to help you 
for customers to relate to companies. reach your marketing objectives. For 


The problem today is that every more information, please visit 
http://www.linuxjournal.com/advertising. 
company’s CRM (customer relationship 
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management) system is a silo, each 
with its own silo’d “relationships” with 
customers, all of which are governed 
at call centers by IVR (Interactive Voice 
Response) systems, followed by scripted 
interactions when a customer gets 
through to a human being. If ways can 
be found to normalize the protocols of 
genuine relationships between companies 
and customers, the work of the call center 
can be made far more easy and efficient. 
In fact, the only way that can happen is if 
the customer's side does the normalizing. 
Once that happens, both sides 
can learn far more from each other, 
in far better ways. If the product 
is the platform for a genuine two- 
way relationship, both company and 
customer are in far better positions to 
learn from each other. Companies can 
update manuals and provide notices of 
firmware updates. Customers can tell 
companies directly what's working or 
not working, how the product might be 
improved and what new products the 
company might consider making. 
We also can start to evolve past 
the current marketing system, by 
which makers and sellers labor 
constantly to entrap and coerce 
customers into restrictive dependencies. 
Communications inside silo’d coercive 
systems tend to be far more restrictive, 
and far less useful, than communications 
between free and independent parties 
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who are ready and able truly to help 
each other. 

At this point, as T.Rob says in his 
article in this issue, we’re still at the 
beginning of whatever it is we'll make 
of personal clouds. CloudOS itself is 
about where Linux was in the months 
after Linus wrote “I’m doing a (free) 
operating system...”. But the population 
of available hackers for personal cloud 
projects is several orders of magnitude 
larger than the one to which Linus 
wrote. Yet, the challenge is remarkably 
similar: take something that has been 
purely corporate (in this case, “the 
cloud”), make it personal, and then 
ramp it out to everything it might 
conceivably work on, improving it along 
the way, and not stopping. 

The result, if all goes according to 
plan, is a true Internet of Things and the 
reframing of business around fully useful 
relationships between customers and 
companies—or, for that matter, between 
anybody and anything.@ 


Doc Searls is Senior Editor of Linux Journal. He is also a 
fellow with the Berkman Center for Internet and Society at 
Harvard University and the Center for Information Technology 
and Society at UC Santa Barbara. 
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